@modusensus/dsh-mneme 0.8.3 → 0.8.5

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 (205) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +727 -636
  3. package/bin/cli.mjs +0 -0
  4. package/bin/dsh-mneme-mcp.mjs +510 -0
  5. package/cordis.patch.yml +21 -21
  6. package/lib/api-standalone.js +506 -316
  7. package/lib/api.js +1403 -1316
  8. package/lib/bootstrap.js +211 -0
  9. package/lib/client.js +4657 -4366
  10. package/lib/commands.js +95 -95
  11. package/lib/config.js +615 -510
  12. package/lib/document.js +221 -0
  13. package/lib/dream/clustering.js +118 -118
  14. package/lib/dream/decisions.js +658 -658
  15. package/lib/dream/narratives.js +44 -0
  16. package/lib/dream/sleep.js +702 -700
  17. package/lib/dream.js +147 -16
  18. package/lib/embedding.js +177 -177
  19. package/lib/entities/extractor.js +249 -249
  20. package/lib/guide.js +44 -0
  21. package/lib/heat.js +144 -136
  22. package/lib/hot-memory.js +46 -46
  23. package/lib/index.js +515 -515
  24. package/lib/inject.js +375 -295
  25. package/lib/lang.js +208 -179
  26. package/lib/local-embedder.js +320 -320
  27. package/lib/mirror.js +198 -198
  28. package/lib/organize.js +450 -0
  29. package/lib/quality-filter.js +126 -126
  30. package/lib/recall-stats.js +125 -0
  31. package/lib/reranker.js +269 -269
  32. package/lib/runtime/adopt.js +176 -176
  33. package/lib/runtime/closure.js +172 -172
  34. package/lib/runtime/download.js +247 -247
  35. package/lib/runtime/layout.js +265 -235
  36. package/lib/runtime/loader.js +252 -249
  37. package/lib/runtime/model-fetch.js +361 -361
  38. package/lib/runtime/provision.js +237 -237
  39. package/lib/runtime/tarball.js +130 -130
  40. package/lib/runtime/verify.js +204 -191
  41. package/lib/scope.js +118 -118
  42. package/lib/search/adaptive.js +60 -22
  43. package/lib/search/bm25.js +96 -96
  44. package/lib/service.js +2324 -2087
  45. package/lib/settings.js +459 -420
  46. package/lib/store.js +2549 -2367
  47. package/lib/summarize.js +820 -449
  48. package/lib/tools.js +702 -574
  49. package/lib/vector-index.js +110 -110
  50. package/lib/version-check.js +122 -122
  51. package/package.json +109 -108
  52. package/runtime-manifest.json +526 -596
  53. package/scripts/benchmark-embed.js +201 -201
  54. package/scripts/benchmark-recall.js +199 -199
  55. package/scripts/benchmark-rerank.js +166 -166
  56. package/scripts/build-runtime-manifest.mjs +224 -217
  57. package/scripts/check-sync.js +42 -42
  58. package/scripts/e2e-dsh.js +220 -220
  59. package/scripts/mneme-runtime.mjs +277 -277
  60. package/scripts/stress-dsh.js +255 -255
  61. package/scripts/sync-lib.js +47 -47
  62. package/scripts/sync-test-badge.mjs +67 -61
  63. package/src/api-standalone.js +506 -316
  64. package/src/api.js +1403 -1316
  65. package/src/bootstrap.js +211 -0
  66. package/src/commands.js +95 -95
  67. package/src/config.js +615 -510
  68. package/src/document.js +221 -0
  69. package/src/dream/clustering.js +118 -118
  70. package/src/dream/decisions.js +658 -658
  71. package/src/dream/narratives.js +44 -0
  72. package/src/dream/sleep.js +702 -700
  73. package/src/dream.js +147 -16
  74. package/src/embedding.js +177 -177
  75. package/src/entities/extractor.js +249 -249
  76. package/src/guide.js +44 -0
  77. package/src/heat.js +144 -136
  78. package/src/hot-memory.js +46 -46
  79. package/src/index.js +515 -515
  80. package/src/inject.js +375 -295
  81. package/src/lang.js +208 -179
  82. package/src/local-embedder.js +320 -320
  83. package/src/mirror.js +198 -198
  84. package/src/organize.js +450 -0
  85. package/src/quality-filter.js +126 -126
  86. package/src/recall-stats.js +125 -0
  87. package/src/reranker.js +269 -269
  88. package/src/runtime/adopt.js +176 -176
  89. package/src/runtime/closure.js +172 -172
  90. package/src/runtime/download.js +247 -247
  91. package/src/runtime/layout.js +265 -235
  92. package/src/runtime/loader.js +252 -249
  93. package/src/runtime/model-fetch.js +361 -361
  94. package/src/runtime/provision.js +237 -237
  95. package/src/runtime/tarball.js +130 -130
  96. package/src/runtime/verify.js +204 -191
  97. package/src/scope.js +118 -118
  98. package/src/search/adaptive.js +60 -22
  99. package/src/search/bm25.js +96 -96
  100. package/src/service.js +2324 -2087
  101. package/src/settings.js +459 -420
  102. package/src/store.js +2549 -2367
  103. package/src/summarize.js +820 -449
  104. package/src/tools.js +702 -574
  105. package/src/vector-index.js +110 -110
  106. package/src/version-check.js +122 -122
  107. package/test/adaptive-inject-budget.test.js +85 -0
  108. package/test/api-routes-gaps.test.js +218 -218
  109. package/test/api.test.js +1640 -1482
  110. package/test/audit.test.js +448 -448
  111. package/test/benchmark.test.js +94 -94
  112. package/test/bootstrap.test.js +220 -0
  113. package/test/client.test.js +860 -736
  114. package/test/clustering.test.js +100 -100
  115. package/test/commands.test.js +106 -106
  116. package/test/config.test.js +66 -66
  117. package/test/conflict-freeze.test.js +300 -300
  118. package/test/document.test.js +523 -0
  119. package/test/dream-archive-guardrail.test.js +116 -116
  120. package/test/dream-candidate-hybrid.test.js +281 -281
  121. package/test/dream-coverage-degrade.test.js +86 -86
  122. package/test/dream.test.js +1308 -1254
  123. package/test/embedding-ready.test.js +196 -196
  124. package/test/entities.test.js +547 -547
  125. package/test/entity-recall.test.js +179 -0
  126. package/test/epistemic.test.js +298 -298
  127. package/test/fnew-0112.test.js +311 -311
  128. package/test/fnew-03.test.js +422 -422
  129. package/test/graph-api.test.js +175 -175
  130. package/test/heat.test.js +175 -148
  131. package/test/helpers/dream-mock.js +82 -82
  132. package/test/helpers/peer-worker.mjs +25 -25
  133. package/test/helpers/runtime-source.js +60 -60
  134. package/test/helpers/tar-builder.js +80 -80
  135. package/test/hot-memory.test.js +145 -145
  136. package/test/inject-content-cap.test.js +91 -0
  137. package/test/inject-first-round-bm25.test.js +89 -89
  138. package/test/inject-heat.test.js +61 -0
  139. package/test/inject-pools.test.js +170 -0
  140. package/test/inject-recall.test.js +105 -0
  141. package/test/inject-rotation.test.js +161 -161
  142. package/test/inject.test.js +283 -249
  143. package/test/lang.test.js +87 -87
  144. package/test/lib-smoke.test.js +96 -96
  145. package/test/llm-audit.test.js +462 -309
  146. package/test/llm-message-source.test.js +177 -177
  147. package/test/local-embedder.test.js +249 -249
  148. package/test/mcp-stdio.test.js +385 -0
  149. package/test/mirror-dirty.test.js +424 -424
  150. package/test/mirror-edit-digest.test.js +187 -187
  151. package/test/mirror-generation.test.js +499 -499
  152. package/test/mirror.test.js +249 -249
  153. package/test/narrative-bars.test.js +162 -0
  154. package/test/organize.test.js +418 -0
  155. package/test/peer-blockers.test.js +193 -193
  156. package/test/policy-epoch.test.js +259 -259
  157. package/test/quality-filter.test.js +186 -186
  158. package/test/reasoning-effort.test.js +746 -746
  159. package/test/recall-evals.test.js +235 -235
  160. package/test/recall-layer.test.js +326 -326
  161. package/test/recall-stats.test.js +123 -0
  162. package/test/receipt-chain.test.js +451 -451
  163. package/test/reflection.test.js +226 -226
  164. package/test/reindex-backfill.test.js +62 -62
  165. package/test/reranker-single-logit.test.js +73 -73
  166. package/test/reranker.test.js +197 -197
  167. package/test/resident-status.test.js +83 -0
  168. package/test/runtime-adopt.test.js +206 -206
  169. package/test/runtime-cli.test.js +89 -89
  170. package/test/runtime-closure.test.js +193 -193
  171. package/test/runtime-download.test.js +302 -302
  172. package/test/runtime-layout.test.js +163 -163
  173. package/test/runtime-loader.test.js +255 -237
  174. package/test/runtime-manifest.test.js +159 -158
  175. package/test/runtime-model-fetch.test.js +348 -348
  176. package/test/runtime-provision.test.js +101 -101
  177. package/test/runtime-tarball.test.js +81 -81
  178. package/test/runtime-verify.test.js +279 -214
  179. package/test/scope-candidates.test.js +239 -239
  180. package/test/scope-explicit.test.js +452 -452
  181. package/test/scope-retrieval.test.js +197 -197
  182. package/test/scope-storage.test.js +255 -255
  183. package/test/scope-strict.test.js +231 -231
  184. package/test/search-fusion.test.js +90 -90
  185. package/test/semantic.test.js +124 -124
  186. package/test/service-search.test.js +174 -174
  187. package/test/service.test.js +405 -405
  188. package/test/settings.test.js +261 -261
  189. package/test/skip-invalid-restore.test.js +262 -262
  190. package/test/sleep-action-set.test.js +422 -422
  191. package/test/sleep-heat.test.js +126 -125
  192. package/test/sleep-scheduler-rearm.test.js +89 -89
  193. package/test/sleep.test.js +410 -373
  194. package/test/standalone-api.test.js +544 -359
  195. package/test/store-vector-cache.test.js +98 -98
  196. package/test/store.test.js +396 -383
  197. package/test/stress.test.js +209 -209
  198. package/test/summarize.test.js +1288 -575
  199. package/test/tools-dto-schema-matrix.test.js +325 -0
  200. package/test/tools-memory-get-schema.test.js +65 -65
  201. package/test/tools.test.js +374 -341
  202. package/test/updated-at-semantics.test.js +113 -113
  203. package/test/vector-index.test.js +221 -221
  204. package/test/version-check.test.js +152 -152
  205. package/test/webServer-optional.test.js +82 -82
@@ -1,298 +1,298 @@
1
- import test from "node:test";
2
- import assert from "node:assert/strict";
3
- import { DatabaseSync } from "node:sqlite";
4
- import { mkdtempSync, rmSync } from "node:fs";
5
- import { tmpdir } from "node:os";
6
- import { join } from "node:path";
7
- import { createStore } from "../src/store.js";
8
- import { createService } from "../src/service.js";
9
- import { createVectorIndex } from "../src/vector-index.js";
10
- import { createInjector } from "../src/inject.js";
11
- import { createSettings } from "../src/settings.js";
12
- import { applyDecisions } from "../src/dream.js";
13
-
14
- // ---------------------------------------------------------------- schema / legacy compat
15
-
16
- test("default epistemic_status is subjective (legacy-compatible)", () => {
17
- const store = createStore(":memory:");
18
- const saved = store.save({ type: "preference", title: "语言", content: "用户用中文交流" });
19
- assert.equal(saved.epistemic_status, "subjective", "no signal -> default subjective");
20
- assert.equal(store.getById(saved.id).epistemic_status, "subjective");
21
- store.close();
22
- });
23
-
24
- test("legacy DB without the column is migrated, old rows read back as subjective", () => {
25
- const dir = mkdtempSync(join(tmpdir(), "dsh-mneme-epistemic-"));
26
- const dbPath = join(dir, "memory.db");
27
- try {
28
- const old = new DatabaseSync(dbPath);
29
- old.exec(`
30
- CREATE TABLE memories (
31
- id TEXT PRIMARY KEY, type TEXT NOT NULL, title TEXT NOT NULL, content TEXT NOT NULL,
32
- tags TEXT NOT NULL DEFAULT '[]', importance INTEGER NOT NULL DEFAULT 3, forgotten INTEGER NOT NULL DEFAULT 0,
33
- source TEXT, embedding TEXT, created_at TEXT NOT NULL, updated_at TEXT NOT NULL
34
- );
35
- INSERT INTO memories (id, type, title, content, tags, importance, forgotten, created_at, updated_at)
36
- VALUES ('legacy', 'preference', '旧偏好', '用户以前说过', '[]', 3, 0, 't', 't');
37
- `);
38
- old.close();
39
-
40
- const store = createStore(dbPath);
41
- const cols = store.db.prepare("PRAGMA table_info(memories)").all().map((c) => c.name);
42
- assert.ok(cols.includes("epistemic_status"), "column added by migration");
43
- const legacy = store.getById("legacy");
44
- assert.equal(legacy.title, "旧偏好", "legacy row preserved");
45
- assert.equal(legacy.epistemic_status, "subjective", "legacy row defaults to subjective");
46
- // New writes on the migrated DB still work with the column.
47
- const saved = store.save({ type: "preference", title: "新", content: "实测结果可用" });
48
- assert.equal(saved.epistemic_status, "observation");
49
- store.close();
50
- } finally {
51
- rmSync(dir, { recursive: true, force: true });
52
- }
53
- });
54
-
55
- // ---------------------------------------------------------------- write inference
56
-
57
- test("content-based inference: subjective markers -> subjective", () => {
58
- const store = createStore(":memory:");
59
- const a = store.save({ type: "preference", title: "天气", content: "我推测明天可能会下雨" });
60
- const b = store.save({ type: "preference", title: "口味", content: "我觉得用户喜欢甜的" });
61
- assert.equal(a.epistemic_status, "subjective");
62
- assert.equal(b.epistemic_status, "subjective");
63
- store.close();
64
- });
65
-
66
- test("content-based inference: observation markers -> observation", () => {
67
- const store = createStore(":memory:");
68
- const a = store.save({ type: "project", title: "温度", content: "实测温度为35度,数据显示稳定" });
69
- const b = store.save({ type: "project", title: "观察", content: "观察到用户总是先点保存" });
70
- assert.equal(a.epistemic_status, "observation");
71
- assert.equal(b.epistemic_status, "observation");
72
- store.close();
73
- });
74
-
75
- test("content-based inference: inference markers -> inferred", () => {
76
- const store = createStore(":memory:");
77
- const a = store.save({ type: "decision", title: "喜好", content: "根据历史记录推断他喜欢猫" });
78
- const b = store.save({ type: "decision", title: "趋势", content: "综上,结论是可推断的" });
79
- assert.equal(a.epistemic_status, "inferred");
80
- assert.equal(b.epistemic_status, "inferred");
81
- store.close();
82
- });
83
-
84
- test("AI-generated types (summary/pattern) are always inferred", () => {
85
- const store = createStore(":memory:");
86
- const s = store.save({ type: "summary", title: "总览", content: "实测数据汇总" });
87
- const p = store.save({ type: "pattern", title: "模式", content: "用户反复这样操作" });
88
- assert.equal(s.epistemic_status, "inferred");
89
- assert.equal(p.epistemic_status, "inferred");
90
- store.close();
91
- });
92
-
93
- test("explicit epistemic_status wins over content inference", () => {
94
- const store = createStore(":memory:");
95
- const saved = store.save({ type: "preference", title: "x", content: "我觉得可能", epistemic_status: "observation" });
96
- assert.equal(saved.epistemic_status, "observation", "explicit value respected");
97
- store.close();
98
- });
99
-
100
- test("update re-infers when content changes, keeps status otherwise", () => {
101
- const store = createStore(":memory:");
102
- const saved = store.save({ type: "preference", title: "x", content: "我觉得可能" });
103
- assert.equal(saved.epistemic_status, "subjective");
104
- // content unchanged -> status kept
105
- const untouched = store.update(saved.id, { title: "y" });
106
- assert.equal(untouched.epistemic_status, "subjective");
107
- // content changed to observation -> status re-inferred
108
- const reInferred = store.update(saved.id, { content: "实测结果显示没问题" });
109
- assert.equal(reInferred.epistemic_status, "observation");
110
- store.close();
111
- });
112
-
113
- test("update re-infers when TYPE changes to summary/pattern (regression)", () => {
114
- const store = createStore(":memory:");
115
- const saved = store.save({ type: "project", title: "x", content: "我觉得可能" });
116
- assert.equal(saved.epistemic_status, "subjective");
117
- // type -> summary: summary/pattern are always inferred, so status must flip
118
- const asSummary = store.update(saved.id, { type: "summary" });
119
- assert.equal(asSummary.epistemic_status, "inferred");
120
- store.close();
121
- });
122
-
123
- // ---------------------------------------------------------------- retrieval ranking
124
-
125
- const embedder = {
126
- embedSingle: async () => [1, 0, 0],
127
- embed: async () => [1, 0, 0],
128
- schedule: () => {},
129
- modelHash: "mock#1",
130
- dimension: 3
131
- };
132
-
133
- test("retrieval ranking: switch off leaves scores and order untouched", async () => {
134
- const store = createStore(":memory:");
135
- const service = createService({ store, mirror: null, config: {} });
136
- const a = service.saveWithDedupe({ type: "preference", title: "猫A", content: "我觉得猫很可爱", importance: 5 });
137
- const b = service.saveWithDedupe({ type: "preference", title: "猫B", content: "实测猫很可爱", importance: 3 });
138
- assert.equal(a.memory.epistemic_status, "subjective");
139
- assert.equal(b.memory.epistemic_status, "observation");
140
-
141
- const rows = await service.searchMemories("猫", { mode: "keyword", topK: 10 });
142
- assert.equal(rows[0].id, a.memory.id, "subjective first under default importance order");
143
- assert.equal(rows[0].score, 1.0, "subjective keeps its raw score (1.0) when off");
144
- assert.equal(rows[1].score, 0.8, "observation keeps its raw score (0.8) when off");
145
- store.close();
146
- });
147
-
148
- test("retrieval ranking: switch on re-weights and re-orders mixed recall", async () => {
149
- const store = createStore(":memory:");
150
- const service = createService({ store, mirror: null, config: { trustEpistemicWeighting: true } });
151
- const vi = createVectorIndex({ store });
152
- service.setEmbedder(embedder);
153
- service.setVectorIndex(vi);
154
- const subj = service.saveWithDedupe({ type: "preference", title: "量子计算", content: "我觉得量子计算很难", importance: 5 });
155
- const obs = service.saveWithDedupe({ type: "preference", title: "量子计算实践", content: "实测量子计算简单", importance: 3 });
156
- vi.saveEmbedding(subj.memory.id, [1, 0, 0]);
157
- vi.saveEmbedding(obs.memory.id, [1, 0, 0]);
158
- assert.equal(subj.memory.epistemic_status, "subjective");
159
- assert.equal(obs.memory.epistemic_status, "observation");
160
-
161
- // hybrid blend (default 0.6/0.4): subjective 1.0*0.6+1.0*0.4=1.0;
162
- // observation 1.0*0.6+0.8*0.4=0.92. After weighting: 1.0*0.7=0.7 vs 0.92*1.0=0.92.
163
- const rows = await service.searchMemories("量子计算", { mode: "hybrid", topK: 10 });
164
- const byId = new Map(rows.map((r) => [r.id, r]));
165
- assert.equal(byId.get(subj.memory.id).score, 0.7, "subjective weighted to 0.7");
166
- assert.equal(byId.get(obs.memory.id).score, 0.92, "observation weighted to 0.92");
167
- assert.equal(rows[0].id, obs.memory.id, "observation outranks subjective when weighting is on");
168
- store.close();
169
- });
170
-
171
- // ---------------------------------------------------------------- injection marking
172
-
173
- function setupInjector(over = {}) {
174
- const store = createStore(":memory:");
175
- const service = createService({ store, mirror: null, config: {} });
176
- const settings = createSettings(store.db);
177
- const contexts = [];
178
- const ctx = {
179
- systemPrompt: {
180
- context(def) {
181
- contexts.push(def);
182
- return () => {};
183
- }
184
- }
185
- };
186
- const config = { maxInjectedItems: 3, importanceThreshold: 3, ...over };
187
- createInjector(ctx, service, settings, config);
188
- return { store, service, contexts };
189
- }
190
-
191
- test("injection marks observation memories [verified] only when enabled", () => {
192
- const { service, contexts } = setupInjector({ trustEpistemicWeighting: true });
193
- service.saveWithDedupe({ type: "preference", title: "偏好实测", content: "实测用户喜欢用命令行", importance: 5 });
194
- service.saveWithDedupe({ type: "preference", title: "偏好推测", content: "我觉得用户可能喜欢GUI", importance: 5 });
195
- const text = contexts[0].text({});
196
- assert.ok(text.includes("[verified] 偏好实测"), "observation memory is flagged");
197
- assert.ok(!text.includes("[verified] 偏好推测"), "subjective memory is not flagged");
198
- });
199
-
200
- test("injection never adds [verified] when the switch is off", () => {
201
- const { service, contexts } = setupInjector({});
202
- service.saveWithDedupe({ type: "preference", title: "偏好实测", content: "实测用户喜欢用命令行", importance: 5 });
203
- const text = contexts[0].text({});
204
- assert.ok(text.includes("偏好实测"), "memory still injected");
205
- assert.ok(!text.includes("[verified]"), "no verified marker when off");
206
- });
207
-
208
- // ---------------------------------------------------------------- decision priority
209
-
210
- test("merge keepSource prefers observation when enabled", () => {
211
- const store = createStore(":memory:");
212
- const service = createService({ store, mirror: null, config: {} });
213
- const config = { trustEpistemicWeighting: true };
214
- const a = service.saveWithDedupe({ type: "project", title: "插件甲", content: "我觉得应该用A方案", importance: 3 });
215
- const b = service.saveWithDedupe({ type: "project", title: "插件乙", content: "实测结果显示B方案更好", importance: 4 });
216
- assert.equal(a.memory.epistemic_status, "subjective");
217
- assert.equal(b.memory.epistemic_status, "observation");
218
-
219
- const { committed } = applyDecisions(
220
- [{ action: "merge", ids: [a.memory.id, b.memory.id], title: "插件总览", content: "合并", keepSource: a.memory.id }],
221
- service, null, null, config
222
- );
223
- assert.equal(committed[0].keepSource, b.memory.id, "keepSource switched to the observation memory");
224
- assert.equal(store.getById(b.memory.id).archived, false, "observation keeper stays live");
225
- assert.equal(store.getById(a.memory.id).archived, true, "subjective source archived");
226
- });
227
-
228
- test("merge keepSource keeps the LLM choice when disabled", () => {
229
- const store = createStore(":memory:");
230
- const service = createService({ store, mirror: null, config: {} });
231
- const a = service.saveWithDedupe({ type: "project", title: "插件甲", content: "我觉得应该用A方案", importance: 3 });
232
- const b = service.saveWithDedupe({ type: "project", title: "插件乙", content: "实测结果显示B方案更好", importance: 4 });
233
- const { committed } = applyDecisions(
234
- [{ action: "merge", ids: [a.memory.id, b.memory.id], title: "插件总览", content: "合并", keepSource: a.memory.id }],
235
- service
236
- );
237
- assert.equal(committed[0].keepSource, a.memory.id, "LLM keepSource respected when off");
238
- assert.equal(store.getById(a.memory.id).archived, false);
239
- assert.equal(store.getById(b.memory.id).archived, true);
240
- });
241
-
242
- test("merge never promotes an ARCHIVED observation to keeper when enabled (regression)", () => {
243
- const store = createStore(":memory:");
244
- const service = createService({ store, mirror: null, config: {} });
245
- const config = { trustEpistemicWeighting: true };
246
- // a = live subjective (LLM's keepSource), b = live observation,
247
- // c = ARCHIVED observation. Pre-fix pickBestKeeper would pick c (highest
248
- // priority, no archived check) as keeper, hit the archived-keeper guard in
249
- // applyMerge and silently drop the merge — the live b never merges.
250
- const a = service.saveWithDedupe({ type: "project", title: "甲", content: "我觉得A方案", importance: 3 });
251
- const b = service.saveWithDedupe({ type: "project", title: "乙", content: "实测B方案更好", importance: 4 });
252
- const c = service.saveWithDedupe({ type: "project", title: "丙", content: "实测C方案最好", importance: 4 });
253
- service.setArchived(c.memory.id, true);
254
-
255
- const { committed } = applyDecisions(
256
- [{ action: "merge", ids: [a.memory.id, b.memory.id, c.memory.id], title: "合并", content: "合并", keepSource: a.memory.id }],
257
- service, null, null, config
258
- );
259
- // c (archived) must NOT be promoted; the live observation b becomes keeper,
260
- // and the merge actually lands.
261
- assert.equal(committed.length, 1, "merge actually committed (not silently skipped)");
262
- assert.equal(committed[0].keepSource, b.memory.id, "live observation promoted over archived one");
263
- assert.equal(store.getById(b.memory.id).archived, false, "observation keeper stays live");
264
- assert.equal(store.getById(a.memory.id).archived, true, "subjective source archived");
265
- assert.equal(store.getById(c.memory.id).archived, true, "archived c stays archived");
266
- });
267
-
268
- test("conflict resolution prefers the observation side as winner when enabled", () => {
269
- const store = createStore(":memory:");
270
- const service = createService({ store, mirror: null, config: {} });
271
- const config = { trustEpistemicWeighting: true };
272
- const w = service.saveWithDedupe({ type: "decision", title: "截止1", content: "我觉得截止是8月20日", importance: 4 });
273
- const l = service.saveWithDedupe({ type: "decision", title: "截止2", content: "实测截止是8月15日", importance: 4 });
274
- assert.equal(w.memory.epistemic_status, "subjective");
275
- assert.equal(l.memory.epistemic_status, "observation");
276
-
277
- const { committed } = applyDecisions(
278
- [{ action: "conflict", winner: w.memory.id, loser: l.memory.id, reason: "日期更新" }],
279
- service, null, null, config
280
- );
281
- assert.equal(committed[0].winner, l.memory.id, "winner swapped to the observation memory");
282
- assert.equal(store.getById(l.memory.id).archived, false, "observation winner stays live");
283
- assert.equal(store.getById(w.memory.id).archived, true, "subjective loser archived");
284
- });
285
-
286
- test("conflict resolution keeps the LLM winner when disabled", () => {
287
- const store = createStore(":memory:");
288
- const service = createService({ store, mirror: null, config: {} });
289
- const w = service.saveWithDedupe({ type: "decision", title: "截止1", content: "我觉得截止是8月20日", importance: 4 });
290
- const l = service.saveWithDedupe({ type: "decision", title: "截止2", content: "实测截止是8月15日", importance: 4 });
291
- const { committed } = applyDecisions(
292
- [{ action: "conflict", winner: w.memory.id, loser: l.memory.id, reason: "日期更新" }],
293
- service
294
- );
295
- assert.equal(committed[0].winner, w.memory.id, "LLM winner respected when off");
296
- assert.equal(store.getById(w.memory.id).archived, false);
297
- assert.equal(store.getById(l.memory.id).archived, true);
298
- });
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import { DatabaseSync } from "node:sqlite";
4
+ import { mkdtempSync, rmSync } from "node:fs";
5
+ import { tmpdir } from "node:os";
6
+ import { join } from "node:path";
7
+ import { createStore } from "../src/store.js";
8
+ import { createService } from "../src/service.js";
9
+ import { createVectorIndex } from "../src/vector-index.js";
10
+ import { createInjector } from "../src/inject.js";
11
+ import { createSettings } from "../src/settings.js";
12
+ import { applyDecisions } from "../src/dream.js";
13
+
14
+ // ---------------------------------------------------------------- schema / legacy compat
15
+
16
+ test("default epistemic_status is subjective (legacy-compatible)", () => {
17
+ const store = createStore(":memory:");
18
+ const saved = store.save({ type: "preference", title: "语言", content: "用户用中文交流" });
19
+ assert.equal(saved.epistemic_status, "subjective", "no signal -> default subjective");
20
+ assert.equal(store.getById(saved.id).epistemic_status, "subjective");
21
+ store.close();
22
+ });
23
+
24
+ test("legacy DB without the column is migrated, old rows read back as subjective", () => {
25
+ const dir = mkdtempSync(join(tmpdir(), "dsh-mneme-epistemic-"));
26
+ const dbPath = join(dir, "memory.db");
27
+ try {
28
+ const old = new DatabaseSync(dbPath);
29
+ old.exec(`
30
+ CREATE TABLE memories (
31
+ id TEXT PRIMARY KEY, type TEXT NOT NULL, title TEXT NOT NULL, content TEXT NOT NULL,
32
+ tags TEXT NOT NULL DEFAULT '[]', importance INTEGER NOT NULL DEFAULT 3, forgotten INTEGER NOT NULL DEFAULT 0,
33
+ source TEXT, embedding TEXT, created_at TEXT NOT NULL, updated_at TEXT NOT NULL
34
+ );
35
+ INSERT INTO memories (id, type, title, content, tags, importance, forgotten, created_at, updated_at)
36
+ VALUES ('legacy', 'preference', '旧偏好', '用户以前说过', '[]', 3, 0, 't', 't');
37
+ `);
38
+ old.close();
39
+
40
+ const store = createStore(dbPath);
41
+ const cols = store.db.prepare("PRAGMA table_info(memories)").all().map((c) => c.name);
42
+ assert.ok(cols.includes("epistemic_status"), "column added by migration");
43
+ const legacy = store.getById("legacy");
44
+ assert.equal(legacy.title, "旧偏好", "legacy row preserved");
45
+ assert.equal(legacy.epistemic_status, "subjective", "legacy row defaults to subjective");
46
+ // New writes on the migrated DB still work with the column.
47
+ const saved = store.save({ type: "preference", title: "新", content: "实测结果可用" });
48
+ assert.equal(saved.epistemic_status, "observation");
49
+ store.close();
50
+ } finally {
51
+ rmSync(dir, { recursive: true, force: true });
52
+ }
53
+ });
54
+
55
+ // ---------------------------------------------------------------- write inference
56
+
57
+ test("content-based inference: subjective markers -> subjective", () => {
58
+ const store = createStore(":memory:");
59
+ const a = store.save({ type: "preference", title: "天气", content: "我推测明天可能会下雨" });
60
+ const b = store.save({ type: "preference", title: "口味", content: "我觉得用户喜欢甜的" });
61
+ assert.equal(a.epistemic_status, "subjective");
62
+ assert.equal(b.epistemic_status, "subjective");
63
+ store.close();
64
+ });
65
+
66
+ test("content-based inference: observation markers -> observation", () => {
67
+ const store = createStore(":memory:");
68
+ const a = store.save({ type: "project", title: "温度", content: "实测温度为35度,数据显示稳定" });
69
+ const b = store.save({ type: "project", title: "观察", content: "观察到用户总是先点保存" });
70
+ assert.equal(a.epistemic_status, "observation");
71
+ assert.equal(b.epistemic_status, "observation");
72
+ store.close();
73
+ });
74
+
75
+ test("content-based inference: inference markers -> inferred", () => {
76
+ const store = createStore(":memory:");
77
+ const a = store.save({ type: "decision", title: "喜好", content: "根据历史记录推断他喜欢猫" });
78
+ const b = store.save({ type: "decision", title: "趋势", content: "综上,结论是可推断的" });
79
+ assert.equal(a.epistemic_status, "inferred");
80
+ assert.equal(b.epistemic_status, "inferred");
81
+ store.close();
82
+ });
83
+
84
+ test("AI-generated types (summary/pattern) are always inferred", () => {
85
+ const store = createStore(":memory:");
86
+ const s = store.save({ type: "summary", title: "总览", content: "实测数据汇总" });
87
+ const p = store.save({ type: "pattern", title: "模式", content: "用户反复这样操作" });
88
+ assert.equal(s.epistemic_status, "inferred");
89
+ assert.equal(p.epistemic_status, "inferred");
90
+ store.close();
91
+ });
92
+
93
+ test("explicit epistemic_status wins over content inference", () => {
94
+ const store = createStore(":memory:");
95
+ const saved = store.save({ type: "preference", title: "x", content: "我觉得可能", epistemic_status: "observation" });
96
+ assert.equal(saved.epistemic_status, "observation", "explicit value respected");
97
+ store.close();
98
+ });
99
+
100
+ test("update re-infers when content changes, keeps status otherwise", () => {
101
+ const store = createStore(":memory:");
102
+ const saved = store.save({ type: "preference", title: "x", content: "我觉得可能" });
103
+ assert.equal(saved.epistemic_status, "subjective");
104
+ // content unchanged -> status kept
105
+ const untouched = store.update(saved.id, { title: "y" });
106
+ assert.equal(untouched.epistemic_status, "subjective");
107
+ // content changed to observation -> status re-inferred
108
+ const reInferred = store.update(saved.id, { content: "实测结果显示没问题" });
109
+ assert.equal(reInferred.epistemic_status, "observation");
110
+ store.close();
111
+ });
112
+
113
+ test("update re-infers when TYPE changes to summary/pattern (regression)", () => {
114
+ const store = createStore(":memory:");
115
+ const saved = store.save({ type: "project", title: "x", content: "我觉得可能" });
116
+ assert.equal(saved.epistemic_status, "subjective");
117
+ // type -> summary: summary/pattern are always inferred, so status must flip
118
+ const asSummary = store.update(saved.id, { type: "summary" });
119
+ assert.equal(asSummary.epistemic_status, "inferred");
120
+ store.close();
121
+ });
122
+
123
+ // ---------------------------------------------------------------- retrieval ranking
124
+
125
+ const embedder = {
126
+ embedSingle: async () => [1, 0, 0],
127
+ embed: async () => [1, 0, 0],
128
+ schedule: () => {},
129
+ modelHash: "mock#1",
130
+ dimension: 3
131
+ };
132
+
133
+ test("retrieval ranking: switch off leaves scores and order untouched", async () => {
134
+ const store = createStore(":memory:");
135
+ const service = createService({ store, mirror: null, config: {} });
136
+ const a = service.saveWithDedupe({ type: "preference", title: "猫A", content: "我觉得猫很可爱", importance: 5 });
137
+ const b = service.saveWithDedupe({ type: "preference", title: "猫B", content: "实测猫很可爱", importance: 3 });
138
+ assert.equal(a.memory.epistemic_status, "subjective");
139
+ assert.equal(b.memory.epistemic_status, "observation");
140
+
141
+ const rows = await service.searchMemories("猫", { mode: "keyword", topK: 10 });
142
+ assert.equal(rows[0].id, a.memory.id, "subjective first under default importance order");
143
+ assert.equal(rows[0].score, 1.0, "subjective keeps its raw score (1.0) when off");
144
+ assert.equal(rows[1].score, 0.8, "observation keeps its raw score (0.8) when off");
145
+ store.close();
146
+ });
147
+
148
+ test("retrieval ranking: switch on re-weights and re-orders mixed recall", async () => {
149
+ const store = createStore(":memory:");
150
+ const service = createService({ store, mirror: null, config: { trustEpistemicWeighting: true } });
151
+ const vi = createVectorIndex({ store });
152
+ service.setEmbedder(embedder);
153
+ service.setVectorIndex(vi);
154
+ const subj = service.saveWithDedupe({ type: "preference", title: "量子计算", content: "我觉得量子计算很难", importance: 5 });
155
+ const obs = service.saveWithDedupe({ type: "preference", title: "量子计算实践", content: "实测量子计算简单", importance: 3 });
156
+ vi.saveEmbedding(subj.memory.id, [1, 0, 0]);
157
+ vi.saveEmbedding(obs.memory.id, [1, 0, 0]);
158
+ assert.equal(subj.memory.epistemic_status, "subjective");
159
+ assert.equal(obs.memory.epistemic_status, "observation");
160
+
161
+ // hybrid blend (default 0.6/0.4): subjective 1.0*0.6+1.0*0.4=1.0;
162
+ // observation 1.0*0.6+0.8*0.4=0.92. After weighting: 1.0*0.7=0.7 vs 0.92*1.0=0.92.
163
+ const rows = await service.searchMemories("量子计算", { mode: "hybrid", topK: 10 });
164
+ const byId = new Map(rows.map((r) => [r.id, r]));
165
+ assert.equal(byId.get(subj.memory.id).score, 0.7, "subjective weighted to 0.7");
166
+ assert.equal(byId.get(obs.memory.id).score, 0.92, "observation weighted to 0.92");
167
+ assert.equal(rows[0].id, obs.memory.id, "observation outranks subjective when weighting is on");
168
+ store.close();
169
+ });
170
+
171
+ // ---------------------------------------------------------------- injection marking
172
+
173
+ function setupInjector(over = {}) {
174
+ const store = createStore(":memory:");
175
+ const service = createService({ store, mirror: null, config: {} });
176
+ const settings = createSettings(store.db);
177
+ const contexts = [];
178
+ const ctx = {
179
+ systemPrompt: {
180
+ context(def) {
181
+ contexts.push(def);
182
+ return () => {};
183
+ }
184
+ }
185
+ };
186
+ const config = { maxInjectedItems: 3, importanceThreshold: 3, ...over };
187
+ createInjector(ctx, service, settings, config);
188
+ return { store, service, contexts };
189
+ }
190
+
191
+ test("injection marks observation memories [verified] only when enabled", () => {
192
+ const { service, contexts } = setupInjector({ trustEpistemicWeighting: true });
193
+ service.saveWithDedupe({ type: "preference", title: "偏好实测", content: "实测用户喜欢用命令行", importance: 5 });
194
+ service.saveWithDedupe({ type: "preference", title: "偏好推测", content: "我觉得用户可能喜欢GUI", importance: 5 });
195
+ const text = contexts[0].text({});
196
+ assert.ok(text.includes("[verified] 偏好实测"), "observation memory is flagged");
197
+ assert.ok(!text.includes("[verified] 偏好推测"), "subjective memory is not flagged");
198
+ });
199
+
200
+ test("injection never adds [verified] when the switch is off", () => {
201
+ const { service, contexts } = setupInjector({});
202
+ service.saveWithDedupe({ type: "preference", title: "偏好实测", content: "实测用户喜欢用命令行", importance: 5 });
203
+ const text = contexts[0].text({});
204
+ assert.ok(text.includes("偏好实测"), "memory still injected");
205
+ assert.ok(!text.includes("[verified]"), "no verified marker when off");
206
+ });
207
+
208
+ // ---------------------------------------------------------------- decision priority
209
+
210
+ test("merge keepSource prefers observation when enabled", () => {
211
+ const store = createStore(":memory:");
212
+ const service = createService({ store, mirror: null, config: {} });
213
+ const config = { trustEpistemicWeighting: true };
214
+ const a = service.saveWithDedupe({ type: "project", title: "插件甲", content: "我觉得应该用A方案", importance: 3 });
215
+ const b = service.saveWithDedupe({ type: "project", title: "插件乙", content: "实测结果显示B方案更好", importance: 4 });
216
+ assert.equal(a.memory.epistemic_status, "subjective");
217
+ assert.equal(b.memory.epistemic_status, "observation");
218
+
219
+ const { committed } = applyDecisions(
220
+ [{ action: "merge", ids: [a.memory.id, b.memory.id], title: "插件总览", content: "合并", keepSource: a.memory.id }],
221
+ service, null, null, config
222
+ );
223
+ assert.equal(committed[0].keepSource, b.memory.id, "keepSource switched to the observation memory");
224
+ assert.equal(store.getById(b.memory.id).archived, false, "observation keeper stays live");
225
+ assert.equal(store.getById(a.memory.id).archived, true, "subjective source archived");
226
+ });
227
+
228
+ test("merge keepSource keeps the LLM choice when disabled", () => {
229
+ const store = createStore(":memory:");
230
+ const service = createService({ store, mirror: null, config: {} });
231
+ const a = service.saveWithDedupe({ type: "project", title: "插件甲", content: "我觉得应该用A方案", importance: 3 });
232
+ const b = service.saveWithDedupe({ type: "project", title: "插件乙", content: "实测结果显示B方案更好", importance: 4 });
233
+ const { committed } = applyDecisions(
234
+ [{ action: "merge", ids: [a.memory.id, b.memory.id], title: "插件总览", content: "合并", keepSource: a.memory.id }],
235
+ service
236
+ );
237
+ assert.equal(committed[0].keepSource, a.memory.id, "LLM keepSource respected when off");
238
+ assert.equal(store.getById(a.memory.id).archived, false);
239
+ assert.equal(store.getById(b.memory.id).archived, true);
240
+ });
241
+
242
+ test("merge never promotes an ARCHIVED observation to keeper when enabled (regression)", () => {
243
+ const store = createStore(":memory:");
244
+ const service = createService({ store, mirror: null, config: {} });
245
+ const config = { trustEpistemicWeighting: true };
246
+ // a = live subjective (LLM's keepSource), b = live observation,
247
+ // c = ARCHIVED observation. Pre-fix pickBestKeeper would pick c (highest
248
+ // priority, no archived check) as keeper, hit the archived-keeper guard in
249
+ // applyMerge and silently drop the merge — the live b never merges.
250
+ const a = service.saveWithDedupe({ type: "project", title: "甲", content: "我觉得A方案", importance: 3 });
251
+ const b = service.saveWithDedupe({ type: "project", title: "乙", content: "实测B方案更好", importance: 4 });
252
+ const c = service.saveWithDedupe({ type: "project", title: "丙", content: "实测C方案最好", importance: 4 });
253
+ service.setArchived(c.memory.id, true);
254
+
255
+ const { committed } = applyDecisions(
256
+ [{ action: "merge", ids: [a.memory.id, b.memory.id, c.memory.id], title: "合并", content: "合并", keepSource: a.memory.id }],
257
+ service, null, null, config
258
+ );
259
+ // c (archived) must NOT be promoted; the live observation b becomes keeper,
260
+ // and the merge actually lands.
261
+ assert.equal(committed.length, 1, "merge actually committed (not silently skipped)");
262
+ assert.equal(committed[0].keepSource, b.memory.id, "live observation promoted over archived one");
263
+ assert.equal(store.getById(b.memory.id).archived, false, "observation keeper stays live");
264
+ assert.equal(store.getById(a.memory.id).archived, true, "subjective source archived");
265
+ assert.equal(store.getById(c.memory.id).archived, true, "archived c stays archived");
266
+ });
267
+
268
+ test("conflict resolution prefers the observation side as winner when enabled", () => {
269
+ const store = createStore(":memory:");
270
+ const service = createService({ store, mirror: null, config: {} });
271
+ const config = { trustEpistemicWeighting: true };
272
+ const w = service.saveWithDedupe({ type: "decision", title: "截止1", content: "我觉得截止是8月20日", importance: 4 });
273
+ const l = service.saveWithDedupe({ type: "decision", title: "截止2", content: "实测截止是8月15日", importance: 4 });
274
+ assert.equal(w.memory.epistemic_status, "subjective");
275
+ assert.equal(l.memory.epistemic_status, "observation");
276
+
277
+ const { committed } = applyDecisions(
278
+ [{ action: "conflict", winner: w.memory.id, loser: l.memory.id, reason: "日期更新" }],
279
+ service, null, null, config
280
+ );
281
+ assert.equal(committed[0].winner, l.memory.id, "winner swapped to the observation memory");
282
+ assert.equal(store.getById(l.memory.id).archived, false, "observation winner stays live");
283
+ assert.equal(store.getById(w.memory.id).archived, true, "subjective loser archived");
284
+ });
285
+
286
+ test("conflict resolution keeps the LLM winner when disabled", () => {
287
+ const store = createStore(":memory:");
288
+ const service = createService({ store, mirror: null, config: {} });
289
+ const w = service.saveWithDedupe({ type: "decision", title: "截止1", content: "我觉得截止是8月20日", importance: 4 });
290
+ const l = service.saveWithDedupe({ type: "decision", title: "截止2", content: "实测截止是8月15日", importance: 4 });
291
+ const { committed } = applyDecisions(
292
+ [{ action: "conflict", winner: w.memory.id, loser: l.memory.id, reason: "日期更新" }],
293
+ service
294
+ );
295
+ assert.equal(committed[0].winner, w.memory.id, "LLM winner respected when off");
296
+ assert.equal(store.getById(w.memory.id).archived, false);
297
+ assert.equal(store.getById(l.memory.id).archived, true);
298
+ });