@modusensus/dsh-mneme 0.6.8 → 0.6.10

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 (117) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +468 -463
  3. package/cordis.patch.yml +15 -15
  4. package/lib/api.js +783 -783
  5. package/lib/client.js +1754 -1757
  6. package/lib/commands.js +64 -64
  7. package/lib/config.js +298 -288
  8. package/lib/dream/clustering.js +118 -118
  9. package/lib/dream/decisions.js +488 -439
  10. package/lib/dream/sleep.js +561 -561
  11. package/lib/dream/tag-extractor.js +156 -156
  12. package/lib/dream.js +958 -935
  13. package/lib/embedding.js +154 -154
  14. package/lib/entities/extractor.js +242 -242
  15. package/lib/hot-memory.js +53 -53
  16. package/lib/index.js +361 -361
  17. package/lib/inject.js +208 -208
  18. package/lib/local-embedder.js +282 -282
  19. package/lib/mirror.js +170 -170
  20. package/lib/parser/tag.js +59 -59
  21. package/lib/parser/wiki-link.js +38 -38
  22. package/lib/quality-filter.js +123 -123
  23. package/lib/reranker.js +218 -218
  24. package/lib/search/adaptive.js +22 -22
  25. package/lib/search/bm25.js +96 -96
  26. package/lib/search/tag-boost.js +61 -61
  27. package/lib/service.js +1726 -1726
  28. package/lib/settings.js +172 -172
  29. package/lib/store.js +2238 -2238
  30. package/lib/summarize.js +236 -236
  31. package/lib/tools.js +290 -290
  32. package/lib/vector-index.js +116 -116
  33. package/package.json +80 -80
  34. package/scripts/benchmark-embed.js +201 -201
  35. package/scripts/benchmark-recall.js +133 -133
  36. package/scripts/benchmark-rerank.js +166 -166
  37. package/scripts/e2e-dsh.js +218 -218
  38. package/scripts/stress-dsh.js +255 -255
  39. package/scripts/sync-lib.js +52 -52
  40. package/src/api.js +783 -783
  41. package/src/commands.js +64 -64
  42. package/src/config.js +298 -288
  43. package/src/dream/clustering.js +118 -118
  44. package/src/dream/decisions.js +488 -439
  45. package/src/dream/sleep.js +561 -561
  46. package/src/dream/tag-extractor.js +156 -156
  47. package/src/dream.js +958 -935
  48. package/src/embedding.js +154 -154
  49. package/src/entities/extractor.js +242 -242
  50. package/src/hot-memory.js +53 -53
  51. package/src/index.js +361 -361
  52. package/src/inject.js +208 -208
  53. package/src/local-embedder.js +282 -282
  54. package/src/mirror.js +170 -170
  55. package/src/parser/tag.js +59 -59
  56. package/src/parser/wiki-link.js +38 -38
  57. package/src/quality-filter.js +123 -123
  58. package/src/reranker.js +218 -218
  59. package/src/search/adaptive.js +22 -22
  60. package/src/search/bm25.js +96 -96
  61. package/src/search/tag-boost.js +61 -61
  62. package/src/service.js +1726 -1726
  63. package/src/settings.js +172 -172
  64. package/src/store.js +2238 -2238
  65. package/src/summarize.js +236 -236
  66. package/src/tools.js +290 -290
  67. package/src/vector-index.js +116 -116
  68. package/test/api.test.js +594 -594
  69. package/test/audit.test.js +448 -448
  70. package/test/benchmark.test.js +35 -35
  71. package/test/boundary-v0625.test.js +82 -82
  72. package/test/client.test.js +368 -368
  73. package/test/clustering.test.js +100 -100
  74. package/test/commands.test.js +69 -69
  75. package/test/config.test.js +50 -50
  76. package/test/conflict-freeze.test.js +290 -290
  77. package/test/directory.test.js +134 -134
  78. package/test/dream.test.js +1060 -903
  79. package/test/entities.test.js +522 -522
  80. package/test/epistemic.test.js +298 -298
  81. package/test/fnew-0112.test.js +311 -311
  82. package/test/fnew-03.test.js +422 -422
  83. package/test/graph-api.test.js +175 -175
  84. package/test/helpers/dream-mock.js +82 -82
  85. package/test/hot-memory.test.js +174 -174
  86. package/test/inject.test.js +103 -103
  87. package/test/llm-audit.test.js +279 -279
  88. package/test/local-embedder.test.js +227 -227
  89. package/test/mirror-dirty.test.js +424 -424
  90. package/test/mirror-edit-digest.test.js +187 -187
  91. package/test/mirror-generation.test.js +499 -499
  92. package/test/mirror.test.js +249 -249
  93. package/test/normalize-decisions.test.js +120 -120
  94. package/test/peer-blockers.test.js +190 -190
  95. package/test/policy-epoch.test.js +259 -259
  96. package/test/provenance.test.js +103 -103
  97. package/test/quality-filter.test.js +118 -118
  98. package/test/reasoning-effort.test.js +199 -199
  99. package/test/recall-evals.test.js +235 -235
  100. package/test/recall-layer.test.js +315 -315
  101. package/test/receipt-chain.test.js +451 -451
  102. package/test/reflection.test.js +226 -226
  103. package/test/reranker.test.js +240 -240
  104. package/test/search-fusion.test.js +90 -90
  105. package/test/semantic.test.js +124 -124
  106. package/test/service-search.test.js +199 -199
  107. package/test/service.test.js +435 -435
  108. package/test/settings.test.js +118 -118
  109. package/test/sleep.test.js +365 -365
  110. package/test/store.test.js +436 -436
  111. package/test/stress.test.js +209 -209
  112. package/test/summarize.test.js +191 -191
  113. package/test/tag-boost.test.js +125 -125
  114. package/test/tag.test.js +312 -312
  115. package/test/tools.test.js +285 -285
  116. package/test/vector-index.test.js +221 -221
  117. package/test/wiki-link.test.js +332 -332
@@ -1,226 +1,226 @@
1
- import test from "node:test";
2
- import assert from "node:assert/strict";
3
- import { validateDecisions, applyDecisions } from "../src/dream/decisions.js";
4
- import { createStore } from "../src/store.js";
5
- import { createService } from "../src/service.js";
6
-
7
- // snapshot helper: memories eligible for consolidation (non-archived, non-summary)
8
- function makeSnapshot(store) {
9
- const snap = new Map();
10
- for (const m of store.all()) {
11
- if (!m.archived && m.type !== "summary") snap.set(m.id, m);
12
- }
13
- return snap;
14
- }
15
-
16
- function setup() {
17
- const store = createStore(":memory:");
18
- const service = createService({ store, mirror: null, config: {} });
19
- return { store, service };
20
- }
21
-
22
- /** Insert a memory and backdate created_at to `hoursAgo`. */
23
- function seedMemory(service, store, fields, hoursAgo = 48) {
24
- const created = service.saveWithDedupe(fields);
25
- const mem = created.memory;
26
- if (hoursAgo) {
27
- const old = new Date(Date.now() - hoursAgo * 3600000).toISOString();
28
- store.db.prepare("UPDATE memories SET created_at = ? WHERE id = ?").run(old, mem.id);
29
- }
30
- return store.getById(mem.id);
31
- }
32
-
33
- // --- update validation ---------------------------------------------------
34
-
35
- test("update validation rejects multiple ids", () => {
36
- const { store } = setup();
37
- const snap = makeSnapshot(store);
38
- const { ok, errors } = validateDecisions(
39
- [{ action: "update", ids: ["a", "b"], content: "new" }], snap
40
- );
41
- assert.equal(ok, false);
42
- assert.ok(errors.some((e) => e.includes("exactly one id")));
43
- });
44
-
45
- test("update validation rejects no actual change", () => {
46
- const { store, service } = setup();
47
- const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
48
- const snap = makeSnapshot(store);
49
- const { ok, errors } = validateDecisions(
50
- [{ action: "update", ids: [mem.id], content: "喜欢 Python" }], snap
51
- );
52
- assert.equal(ok, false);
53
- assert.ok(errors.some((e) => e.includes("change at least one field")));
54
- });
55
-
56
- test("update validation rejects summary type", () => {
57
- const { store, service } = setup();
58
- const mem = seedMemory(service, store, { type: "summary", title: "总览", content: "overview" });
59
- const snap = makeSnapshot(store);
60
- // summary is excluded from snapshot, so also test direct: simulate by forcing it in
61
- snap.set(mem.id, mem);
62
- const { ok, errors } = validateDecisions(
63
- [{ action: "update", ids: [mem.id], content: "new overview" }], snap
64
- );
65
- assert.equal(ok, false);
66
- assert.ok(errors.some((e) => e.includes("summary") || e.includes("not eligible")));
67
- });
68
-
69
- test("update validation rejects too-young memory (< minAgeHours)", () => {
70
- const { store, service } = setup();
71
- const mem = seedMemory(service, store, { type: "preference", title: "新", content: "新记忆" }, 1); // 1 hour old
72
- const snap = makeSnapshot(store);
73
- const { ok, errors } = validateDecisions(
74
- [{ action: "update", ids: [mem.id], content: "修正" }], snap, { minAgeHours: 24 }
75
- );
76
- assert.equal(ok, false);
77
- assert.ok(errors.some((e) => e.includes("too young")));
78
- });
79
-
80
- test("update validation respects configurable minAgeHours", () => {
81
- const { store, service } = setup();
82
- const mem = seedMemory(service, store, { type: "preference", title: "新", content: "新记忆" }, 1);
83
- const snap = makeSnapshot(store);
84
- // minAgeHours=0 disables the age guard -> update of a 1h-old memory passes
85
- const { ok, errors } = validateDecisions(
86
- [{ action: "update", ids: [mem.id], content: "修正" }], snap, { minAgeHours: 0 }
87
- );
88
- assert.equal(ok, true, errors.join("; "));
89
- });
90
-
91
- test("update validation rejects > maxUpdatePerRun updates", () => {
92
- const { store, service } = setup();
93
- const a = seedMemory(service, store, { type: "preference", title: "A", content: "a" });
94
- const b = seedMemory(service, store, { type: "preference", title: "B", content: "b" });
95
- const c = seedMemory(service, store, { type: "preference", title: "C", content: "c" });
96
- const snap = makeSnapshot(store);
97
- const { ok, errors } = validateDecisions([
98
- { action: "update", ids: [a.id], content: "a2" },
99
- { action: "update", ids: [b.id], content: "b2" },
100
- { action: "update", ids: [c.id], content: "c2" }
101
- ], snap, { maxUpdatePerRun: 2 });
102
- assert.equal(ok, false);
103
- assert.ok(errors.some((e) => e.includes("too many update")));
104
- });
105
-
106
- test("update validation passes a single valid update", () => {
107
- const { store, service } = setup();
108
- const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
109
- const snap = makeSnapshot(store);
110
- const { ok, errors } = validateDecisions(
111
- [{ action: "update", ids: [mem.id], content: "喜欢 Rust" }], snap
112
- );
113
- assert.equal(ok, true, errors.join("; "));
114
- });
115
-
116
- // --- update application --------------------------------------------------
117
-
118
- test("update application changes the memory content", () => {
119
- const { store, service } = setup();
120
- const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
121
- const snap = makeSnapshot(store);
122
- const decisions = [{ action: "update", ids: [mem.id], content: "喜欢 Rust" }];
123
- assert.equal(validateDecisions(decisions, snap).ok, true);
124
- const { applied } = applyDecisions(decisions, service);
125
- assert.equal(applied, 1);
126
- const updated = store.getById(mem.id);
127
- assert.equal(updated.content, "喜欢 Rust");
128
- });
129
-
130
- test("update application is idempotent on replay", () => {
131
- const { store, service } = setup();
132
- const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
133
- const snap = makeSnapshot(store);
134
- const decisions = [{ action: "update", ids: [mem.id], content: "喜欢 Rust" }];
135
- applyDecisions(decisions, service);
136
- const appliedAgain = applyDecisions(decisions, service);
137
- assert.equal(appliedAgain.applied, 0, "replay of an already-applied update should be a no-op");
138
- });
139
-
140
- test("update application preserves unspecified fields", () => {
141
- const { store, service } = setup();
142
- const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python", importance: 3 });
143
- const snap = makeSnapshot(store);
144
- const decisions = [{ action: "update", ids: [mem.id], content: "喜欢 Rust" }];
145
- applyDecisions(decisions, service);
146
- const updated = store.getById(mem.id);
147
- assert.equal(updated.content, "喜欢 Rust");
148
- assert.equal(updated.title, "语言", "title preserved");
149
- assert.equal(updated.importance, 3, "importance preserved");
150
- });
151
-
152
- // --- failure tracking ----------------------------------------------------
153
-
154
- test("user correction records a failure_memories row", () => {
155
- const store = createStore(":memory:");
156
- const service = createService({ store, mirror: null, config: { reflectionFailureTracking: true } });
157
- const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
158
- service.update(mem.id, { content: "喜欢 Rust" });
159
- const failures = store.listFailures();
160
- assert.equal(failures.length, 1);
161
- assert.equal(failures[0].failure_type, "user_correction");
162
- assert.equal(failures[0].memory_id, mem.id);
163
- assert.equal(failures[0].actual, "喜欢 Python");
164
- assert.equal(failures[0].expected, "喜欢 Rust");
165
- });
166
-
167
- test("user correction records failure when only title changes", () => {
168
- const store = createStore(":memory:");
169
- const service = createService({ store, mirror: null, config: { reflectionFailureTracking: true } });
170
- const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
171
- service.update(mem.id, { title: "编程语言" }); // title change, content same
172
- const failures = store.listFailures();
173
- assert.equal(failures.length, 1, "title-only change should still record a failure");
174
- assert.equal(failures[0].failure_type, "user_correction");
175
- });
176
-
177
- test("user correction records query context when provided", () => {
178
- const store = createStore(":memory:");
179
- const service = createService({ store, mirror: null, config: { reflectionFailureTracking: true } });
180
- const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
181
- service.update(mem.id, { content: "喜欢 Rust" }, { query: "用户说:不对,我喜欢 Rust" });
182
- const failures = store.listFailures();
183
- assert.equal(failures.length, 1);
184
- assert.equal(failures[0].query, "用户说:不对,我喜欢 Rust");
185
- });
186
-
187
- test("user correction skips failure when nothing meaningful changes", () => {
188
- const store = createStore(":memory:");
189
- const service = createService({ store, mirror: null, config: { reflectionFailureTracking: true } });
190
- const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python", importance: 3 });
191
- service.update(mem.id, { title: "语言", content: "喜欢 Python", importance: 3 }); // identical
192
- assert.equal(store.listFailures().length, 0, "no meaningful change -> no failure");
193
- });
194
-
195
- test("deleteOldFailures removes rows older than the cutoff", () => {
196
- const store = createStore(":memory:");
197
- const service = createService({ store, mirror: null, config: { reflectionFailureTracking: true } });
198
- const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
199
- service.update(mem.id, { content: "喜欢 Rust" });
200
- assert.equal(store.listFailures().length, 1);
201
- // cutoff in the future: everything is older, so all rows get deleted
202
- const removed = store.deleteOldFailures(new Date(Date.now() + 86400000).toISOString());
203
- assert.equal(removed, 1);
204
- assert.equal(store.listFailures().length, 0);
205
- });
206
-
207
- test("failure tracking disabled by config", () => {
208
- const store = createStore(":memory:");
209
- const service = createService({ store, mirror: null, config: { reflectionFailureTracking: false } });
210
- const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
211
- service.update(mem.id, { content: "喜欢 Rust" });
212
- assert.equal(store.listFailures().length, 0);
213
- });
214
-
215
- test("listFailures and getFailureStats work", () => {
216
- const store = createStore(":memory:");
217
- const service = createService({ store, mirror: null, config: { reflectionFailureTracking: true } });
218
- const a = seedMemory(service, store, { type: "preference", title: "A", content: "x1" });
219
- const b = seedMemory(service, store, { type: "preference", title: "B", content: "y1" });
220
- service.update(a.id, { content: "x2" });
221
- service.update(b.id, { content: "y2" });
222
- const failures = store.listFailures();
223
- assert.equal(failures.length, 2);
224
- const stats = store.getFailureStats();
225
- assert.equal(stats.user_correction, 2);
226
- });
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import { validateDecisions, applyDecisions } from "../src/dream/decisions.js";
4
+ import { createStore } from "../src/store.js";
5
+ import { createService } from "../src/service.js";
6
+
7
+ // snapshot helper: memories eligible for consolidation (non-archived, non-summary)
8
+ function makeSnapshot(store) {
9
+ const snap = new Map();
10
+ for (const m of store.all()) {
11
+ if (!m.archived && m.type !== "summary") snap.set(m.id, m);
12
+ }
13
+ return snap;
14
+ }
15
+
16
+ function setup() {
17
+ const store = createStore(":memory:");
18
+ const service = createService({ store, mirror: null, config: {} });
19
+ return { store, service };
20
+ }
21
+
22
+ /** Insert a memory and backdate created_at to `hoursAgo`. */
23
+ function seedMemory(service, store, fields, hoursAgo = 48) {
24
+ const created = service.saveWithDedupe(fields);
25
+ const mem = created.memory;
26
+ if (hoursAgo) {
27
+ const old = new Date(Date.now() - hoursAgo * 3600000).toISOString();
28
+ store.db.prepare("UPDATE memories SET created_at = ? WHERE id = ?").run(old, mem.id);
29
+ }
30
+ return store.getById(mem.id);
31
+ }
32
+
33
+ // --- update validation ---------------------------------------------------
34
+
35
+ test("update validation rejects multiple ids", () => {
36
+ const { store } = setup();
37
+ const snap = makeSnapshot(store);
38
+ const { ok, errors } = validateDecisions(
39
+ [{ action: "update", ids: ["a", "b"], content: "new" }], snap
40
+ );
41
+ assert.equal(ok, false);
42
+ assert.ok(errors.some((e) => e.includes("exactly one id")));
43
+ });
44
+
45
+ test("update validation rejects no actual change", () => {
46
+ const { store, service } = setup();
47
+ const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
48
+ const snap = makeSnapshot(store);
49
+ const { ok, errors } = validateDecisions(
50
+ [{ action: "update", ids: [mem.id], content: "喜欢 Python" }], snap
51
+ );
52
+ assert.equal(ok, false);
53
+ assert.ok(errors.some((e) => e.includes("change at least one field")));
54
+ });
55
+
56
+ test("update validation rejects summary type", () => {
57
+ const { store, service } = setup();
58
+ const mem = seedMemory(service, store, { type: "summary", title: "总览", content: "overview" });
59
+ const snap = makeSnapshot(store);
60
+ // summary is excluded from snapshot, so also test direct: simulate by forcing it in
61
+ snap.set(mem.id, mem);
62
+ const { ok, errors } = validateDecisions(
63
+ [{ action: "update", ids: [mem.id], content: "new overview" }], snap
64
+ );
65
+ assert.equal(ok, false);
66
+ assert.ok(errors.some((e) => e.includes("summary") || e.includes("not eligible")));
67
+ });
68
+
69
+ test("update validation rejects too-young memory (< minAgeHours)", () => {
70
+ const { store, service } = setup();
71
+ const mem = seedMemory(service, store, { type: "preference", title: "新", content: "新记忆" }, 1); // 1 hour old
72
+ const snap = makeSnapshot(store);
73
+ const { ok, errors } = validateDecisions(
74
+ [{ action: "update", ids: [mem.id], content: "修正" }], snap, { minAgeHours: 24 }
75
+ );
76
+ assert.equal(ok, false);
77
+ assert.ok(errors.some((e) => e.includes("too young")));
78
+ });
79
+
80
+ test("update validation respects configurable minAgeHours", () => {
81
+ const { store, service } = setup();
82
+ const mem = seedMemory(service, store, { type: "preference", title: "新", content: "新记忆" }, 1);
83
+ const snap = makeSnapshot(store);
84
+ // minAgeHours=0 disables the age guard -> update of a 1h-old memory passes
85
+ const { ok, errors } = validateDecisions(
86
+ [{ action: "update", ids: [mem.id], content: "修正" }], snap, { minAgeHours: 0 }
87
+ );
88
+ assert.equal(ok, true, errors.join("; "));
89
+ });
90
+
91
+ test("update validation rejects > maxUpdatePerRun updates", () => {
92
+ const { store, service } = setup();
93
+ const a = seedMemory(service, store, { type: "preference", title: "A", content: "a" });
94
+ const b = seedMemory(service, store, { type: "preference", title: "B", content: "b" });
95
+ const c = seedMemory(service, store, { type: "preference", title: "C", content: "c" });
96
+ const snap = makeSnapshot(store);
97
+ const { ok, errors } = validateDecisions([
98
+ { action: "update", ids: [a.id], content: "a2" },
99
+ { action: "update", ids: [b.id], content: "b2" },
100
+ { action: "update", ids: [c.id], content: "c2" }
101
+ ], snap, { maxUpdatePerRun: 2 });
102
+ assert.equal(ok, false);
103
+ assert.ok(errors.some((e) => e.includes("too many update")));
104
+ });
105
+
106
+ test("update validation passes a single valid update", () => {
107
+ const { store, service } = setup();
108
+ const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
109
+ const snap = makeSnapshot(store);
110
+ const { ok, errors } = validateDecisions(
111
+ [{ action: "update", ids: [mem.id], content: "喜欢 Rust" }], snap
112
+ );
113
+ assert.equal(ok, true, errors.join("; "));
114
+ });
115
+
116
+ // --- update application --------------------------------------------------
117
+
118
+ test("update application changes the memory content", () => {
119
+ const { store, service } = setup();
120
+ const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
121
+ const snap = makeSnapshot(store);
122
+ const decisions = [{ action: "update", ids: [mem.id], content: "喜欢 Rust" }];
123
+ assert.equal(validateDecisions(decisions, snap).ok, true);
124
+ const { applied } = applyDecisions(decisions, service);
125
+ assert.equal(applied, 1);
126
+ const updated = store.getById(mem.id);
127
+ assert.equal(updated.content, "喜欢 Rust");
128
+ });
129
+
130
+ test("update application is idempotent on replay", () => {
131
+ const { store, service } = setup();
132
+ const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
133
+ const snap = makeSnapshot(store);
134
+ const decisions = [{ action: "update", ids: [mem.id], content: "喜欢 Rust" }];
135
+ applyDecisions(decisions, service);
136
+ const appliedAgain = applyDecisions(decisions, service);
137
+ assert.equal(appliedAgain.applied, 0, "replay of an already-applied update should be a no-op");
138
+ });
139
+
140
+ test("update application preserves unspecified fields", () => {
141
+ const { store, service } = setup();
142
+ const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python", importance: 3 });
143
+ const snap = makeSnapshot(store);
144
+ const decisions = [{ action: "update", ids: [mem.id], content: "喜欢 Rust" }];
145
+ applyDecisions(decisions, service);
146
+ const updated = store.getById(mem.id);
147
+ assert.equal(updated.content, "喜欢 Rust");
148
+ assert.equal(updated.title, "语言", "title preserved");
149
+ assert.equal(updated.importance, 3, "importance preserved");
150
+ });
151
+
152
+ // --- failure tracking ----------------------------------------------------
153
+
154
+ test("user correction records a failure_memories row", () => {
155
+ const store = createStore(":memory:");
156
+ const service = createService({ store, mirror: null, config: { reflectionFailureTracking: true } });
157
+ const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
158
+ service.update(mem.id, { content: "喜欢 Rust" });
159
+ const failures = store.listFailures();
160
+ assert.equal(failures.length, 1);
161
+ assert.equal(failures[0].failure_type, "user_correction");
162
+ assert.equal(failures[0].memory_id, mem.id);
163
+ assert.equal(failures[0].actual, "喜欢 Python");
164
+ assert.equal(failures[0].expected, "喜欢 Rust");
165
+ });
166
+
167
+ test("user correction records failure when only title changes", () => {
168
+ const store = createStore(":memory:");
169
+ const service = createService({ store, mirror: null, config: { reflectionFailureTracking: true } });
170
+ const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
171
+ service.update(mem.id, { title: "编程语言" }); // title change, content same
172
+ const failures = store.listFailures();
173
+ assert.equal(failures.length, 1, "title-only change should still record a failure");
174
+ assert.equal(failures[0].failure_type, "user_correction");
175
+ });
176
+
177
+ test("user correction records query context when provided", () => {
178
+ const store = createStore(":memory:");
179
+ const service = createService({ store, mirror: null, config: { reflectionFailureTracking: true } });
180
+ const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
181
+ service.update(mem.id, { content: "喜欢 Rust" }, { query: "用户说:不对,我喜欢 Rust" });
182
+ const failures = store.listFailures();
183
+ assert.equal(failures.length, 1);
184
+ assert.equal(failures[0].query, "用户说:不对,我喜欢 Rust");
185
+ });
186
+
187
+ test("user correction skips failure when nothing meaningful changes", () => {
188
+ const store = createStore(":memory:");
189
+ const service = createService({ store, mirror: null, config: { reflectionFailureTracking: true } });
190
+ const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python", importance: 3 });
191
+ service.update(mem.id, { title: "语言", content: "喜欢 Python", importance: 3 }); // identical
192
+ assert.equal(store.listFailures().length, 0, "no meaningful change -> no failure");
193
+ });
194
+
195
+ test("deleteOldFailures removes rows older than the cutoff", () => {
196
+ const store = createStore(":memory:");
197
+ const service = createService({ store, mirror: null, config: { reflectionFailureTracking: true } });
198
+ const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
199
+ service.update(mem.id, { content: "喜欢 Rust" });
200
+ assert.equal(store.listFailures().length, 1);
201
+ // cutoff in the future: everything is older, so all rows get deleted
202
+ const removed = store.deleteOldFailures(new Date(Date.now() + 86400000).toISOString());
203
+ assert.equal(removed, 1);
204
+ assert.equal(store.listFailures().length, 0);
205
+ });
206
+
207
+ test("failure tracking disabled by config", () => {
208
+ const store = createStore(":memory:");
209
+ const service = createService({ store, mirror: null, config: { reflectionFailureTracking: false } });
210
+ const mem = seedMemory(service, store, { type: "preference", title: "语言", content: "喜欢 Python" });
211
+ service.update(mem.id, { content: "喜欢 Rust" });
212
+ assert.equal(store.listFailures().length, 0);
213
+ });
214
+
215
+ test("listFailures and getFailureStats work", () => {
216
+ const store = createStore(":memory:");
217
+ const service = createService({ store, mirror: null, config: { reflectionFailureTracking: true } });
218
+ const a = seedMemory(service, store, { type: "preference", title: "A", content: "x1" });
219
+ const b = seedMemory(service, store, { type: "preference", title: "B", content: "y1" });
220
+ service.update(a.id, { content: "x2" });
221
+ service.update(b.id, { content: "y2" });
222
+ const failures = store.listFailures();
223
+ assert.equal(failures.length, 2);
224
+ const stats = store.getFailureStats();
225
+ assert.equal(stats.user_correction, 2);
226
+ });