@modusensus/dsh-mneme 0.6.7 → 0.6.9

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 (139) hide show
  1. package/.github/workflows/test.yml +32 -0
  2. package/.release-notes-v0.6.9.md +13 -0
  3. package/CHANGELOG.md +89 -0
  4. package/LICENSE +21 -21
  5. package/README.md +219 -463
  6. package/SECURITY.md +544 -0
  7. package/docs/devlog/2026-08-14-dsh-mneme-dev-log.md +247 -0
  8. package/docs/devlog/2026-08-15-dsh-mneme-audit-stress-dev-log.md +145 -0
  9. package/docs/devlog/2026-08-15-dsh-mneme-pipeline-dev-log.md +56 -0
  10. package/docs/devlog/2026-08-15-dsh-mneme-reflection-dev-log.md +77 -0
  11. package/docs/devlog/2026-08-15-dsh-mneme-review-fixes-dev-log.md +64 -0
  12. package/docs/devlog/2026-08-15-dsh-mneme-semantic-dev-log.md +90 -0
  13. package/dsh-mneme/CHANGELOG.md +248 -0
  14. package/dsh-mneme/LICENSE +21 -0
  15. package/dsh-mneme/README.md +465 -0
  16. package/{cordis.patch.yml → dsh-mneme/cordis.patch.yml} +15 -15
  17. package/dsh-mneme/docs/AGENT_MEMORY_RESEARCH.md +183 -0
  18. package/dsh-mneme/docs/ENTITIES.md +245 -0
  19. package/dsh-mneme/docs/LOCAL_MODEL.md +141 -0
  20. package/dsh-mneme/docs/MIGRATION.md +127 -0
  21. package/dsh-mneme/docs/SEMANTIC.md +256 -0
  22. package/dsh-mneme/docs/SLEEP.md +163 -0
  23. package/{lib → dsh-mneme/lib}/api.js +783 -783
  24. package/{lib → dsh-mneme/lib}/client.js +1757 -1757
  25. package/{src → dsh-mneme/lib}/commands.js +64 -64
  26. package/{lib → dsh-mneme/lib}/config.js +298 -288
  27. package/{lib → dsh-mneme/lib}/dream/clustering.js +118 -118
  28. package/{src → dsh-mneme/lib}/dream/decisions.js +488 -439
  29. package/{lib → dsh-mneme/lib}/dream/sleep.js +561 -554
  30. package/{src → dsh-mneme/lib}/dream/tag-extractor.js +156 -156
  31. package/{lib → dsh-mneme/lib}/dream.js +958 -929
  32. package/{src → dsh-mneme/lib}/embedding.js +154 -154
  33. package/{src → dsh-mneme/lib}/entities/extractor.js +242 -242
  34. package/{src → dsh-mneme/lib}/hot-memory.js +53 -53
  35. package/{lib → dsh-mneme/lib}/index.js +361 -361
  36. package/{src → dsh-mneme/lib}/inject.js +208 -208
  37. package/{lib → dsh-mneme/lib}/local-embedder.js +282 -282
  38. package/{lib → dsh-mneme/lib}/mirror.js +170 -170
  39. package/{lib → dsh-mneme/lib}/parser/tag.js +59 -59
  40. package/{lib → dsh-mneme/lib}/parser/wiki-link.js +38 -38
  41. package/{src → dsh-mneme/lib}/quality-filter.js +123 -123
  42. package/{lib → dsh-mneme/lib}/reranker.js +218 -218
  43. package/{lib → dsh-mneme/lib}/search/adaptive.js +22 -22
  44. package/{lib → dsh-mneme/lib}/search/bm25.js +96 -96
  45. package/{src → dsh-mneme/lib}/search/tag-boost.js +61 -61
  46. package/{src → dsh-mneme/lib}/service.js +1726 -1726
  47. package/{lib → dsh-mneme/lib}/settings.js +172 -172
  48. package/{lib → dsh-mneme/lib}/store.js +2238 -2238
  49. package/{lib → dsh-mneme/lib}/summarize.js +236 -236
  50. package/{lib → dsh-mneme/lib}/tools.js +290 -290
  51. package/{lib → dsh-mneme/lib}/vector-index.js +116 -116
  52. package/dsh-mneme/package-lock.json +1936 -0
  53. package/dsh-mneme/package.json +80 -0
  54. package/{scripts → dsh-mneme/scripts}/benchmark-embed.js +201 -201
  55. package/{scripts → dsh-mneme/scripts}/benchmark-recall.js +133 -133
  56. package/{scripts → dsh-mneme/scripts}/benchmark-rerank.js +166 -166
  57. package/{scripts → dsh-mneme/scripts}/e2e-dsh.js +218 -218
  58. package/{scripts → dsh-mneme/scripts}/stress-dsh.js +255 -255
  59. package/{scripts → dsh-mneme/scripts}/sync-lib.js +52 -52
  60. package/{src → dsh-mneme/src}/api.js +783 -783
  61. package/{lib → dsh-mneme/src}/commands.js +64 -64
  62. package/{src → dsh-mneme/src}/config.js +298 -288
  63. package/{src → dsh-mneme/src}/dream/clustering.js +118 -118
  64. package/{lib → dsh-mneme/src}/dream/decisions.js +488 -439
  65. package/{src → dsh-mneme/src}/dream/sleep.js +561 -554
  66. package/{lib → dsh-mneme/src}/dream/tag-extractor.js +156 -156
  67. package/{src → dsh-mneme/src}/dream.js +958 -929
  68. package/{lib → dsh-mneme/src}/embedding.js +154 -154
  69. package/{lib → dsh-mneme/src}/entities/extractor.js +242 -242
  70. package/{lib → dsh-mneme/src}/hot-memory.js +53 -53
  71. package/{src → dsh-mneme/src}/index.js +361 -361
  72. package/{lib → dsh-mneme/src}/inject.js +208 -208
  73. package/{src → dsh-mneme/src}/local-embedder.js +282 -282
  74. package/{src → dsh-mneme/src}/mirror.js +170 -170
  75. package/{src → dsh-mneme/src}/parser/tag.js +59 -59
  76. package/{src → dsh-mneme/src}/parser/wiki-link.js +38 -38
  77. package/{lib → dsh-mneme/src}/quality-filter.js +123 -123
  78. package/{src → dsh-mneme/src}/reranker.js +218 -218
  79. package/{src → dsh-mneme/src}/search/adaptive.js +22 -22
  80. package/{src → dsh-mneme/src}/search/bm25.js +96 -96
  81. package/{lib → dsh-mneme/src}/search/tag-boost.js +61 -61
  82. package/{lib → dsh-mneme/src}/service.js +1726 -1726
  83. package/{src → dsh-mneme/src}/settings.js +172 -172
  84. package/{src → dsh-mneme/src}/store.js +2238 -2238
  85. package/{src → dsh-mneme/src}/summarize.js +236 -236
  86. package/{src → dsh-mneme/src}/tools.js +290 -290
  87. package/{src → dsh-mneme/src}/vector-index.js +116 -116
  88. package/{test → dsh-mneme/test}/api.test.js +594 -594
  89. package/{test → dsh-mneme/test}/audit.test.js +448 -448
  90. package/{test → dsh-mneme/test}/benchmark.test.js +35 -35
  91. package/{test → dsh-mneme/test}/boundary-v0625.test.js +82 -82
  92. package/{test → dsh-mneme/test}/client.test.js +368 -368
  93. package/{test → dsh-mneme/test}/clustering.test.js +100 -100
  94. package/{test → dsh-mneme/test}/commands.test.js +69 -69
  95. package/{test → dsh-mneme/test}/config.test.js +50 -50
  96. package/{test → dsh-mneme/test}/conflict-freeze.test.js +290 -290
  97. package/{test → dsh-mneme/test}/directory.test.js +134 -134
  98. package/{test → dsh-mneme/test}/dream.test.js +1060 -901
  99. package/{test → dsh-mneme/test}/entities.test.js +522 -522
  100. package/{test → dsh-mneme/test}/epistemic.test.js +298 -298
  101. package/{test → dsh-mneme/test}/fnew-0112.test.js +311 -311
  102. package/{test → dsh-mneme/test}/fnew-03.test.js +422 -422
  103. package/{test → dsh-mneme/test}/graph-api.test.js +175 -175
  104. package/{test → dsh-mneme/test}/helpers/dream-mock.js +82 -82
  105. package/{test → dsh-mneme/test}/hot-memory.test.js +174 -174
  106. package/{test → dsh-mneme/test}/inject.test.js +103 -103
  107. package/{test → dsh-mneme/test}/llm-audit.test.js +279 -279
  108. package/{test → dsh-mneme/test}/local-embedder.test.js +227 -227
  109. package/{test → dsh-mneme/test}/mirror-dirty.test.js +424 -424
  110. package/{test → dsh-mneme/test}/mirror-edit-digest.test.js +187 -187
  111. package/{test → dsh-mneme/test}/mirror-generation.test.js +499 -499
  112. package/{test → dsh-mneme/test}/mirror.test.js +249 -249
  113. package/{test → dsh-mneme/test}/normalize-decisions.test.js +120 -120
  114. package/{test → dsh-mneme/test}/peer-blockers.test.js +190 -190
  115. package/{test → dsh-mneme/test}/policy-epoch.test.js +259 -259
  116. package/{test → dsh-mneme/test}/provenance.test.js +103 -103
  117. package/{test → dsh-mneme/test}/quality-filter.test.js +118 -118
  118. package/{test → dsh-mneme/test}/reasoning-effort.test.js +199 -199
  119. package/{test → dsh-mneme/test}/recall-evals.test.js +235 -235
  120. package/{test → dsh-mneme/test}/recall-layer.test.js +315 -315
  121. package/{test → dsh-mneme/test}/receipt-chain.test.js +451 -451
  122. package/{test → dsh-mneme/test}/reflection.test.js +226 -226
  123. package/{test → dsh-mneme/test}/reranker.test.js +240 -240
  124. package/{test → dsh-mneme/test}/search-fusion.test.js +90 -90
  125. package/{test → dsh-mneme/test}/semantic.test.js +124 -124
  126. package/{test → dsh-mneme/test}/service-search.test.js +199 -199
  127. package/{test → dsh-mneme/test}/service.test.js +435 -435
  128. package/{test → dsh-mneme/test}/settings.test.js +118 -118
  129. package/{test → dsh-mneme/test}/sleep.test.js +365 -365
  130. package/{test → dsh-mneme/test}/store.test.js +436 -436
  131. package/{test → dsh-mneme/test}/stress.test.js +209 -209
  132. package/{test → dsh-mneme/test}/summarize.test.js +191 -191
  133. package/{test → dsh-mneme/test}/tag-boost.test.js +125 -125
  134. package/{test → dsh-mneme/test}/tag.test.js +312 -312
  135. package/{test → dsh-mneme/test}/tools.test.js +285 -285
  136. package/{test → dsh-mneme/test}/vector-index.test.js +221 -221
  137. package/{test → dsh-mneme/test}/wiki-link.test.js +332 -332
  138. package/package.json +18 -40
  139. package//346/250/252/345/271/205.png +0 -0
@@ -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
+ });