@modusensus/dsh-mneme 0.8.2 → 0.8.4

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 (193) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +718 -633
  3. package/bin/cli.mjs +0 -0
  4. package/bin/dsh-mneme-mcp.mjs +502 -0
  5. package/cordis.patch.yml +21 -21
  6. package/lib/api-standalone.js +495 -316
  7. package/lib/api.js +1382 -1316
  8. package/lib/bootstrap.js +211 -0
  9. package/lib/client.js +4475 -4362
  10. package/lib/commands.js +95 -95
  11. package/lib/config.js +533 -500
  12. package/lib/dream/clustering.js +118 -118
  13. package/lib/dream/decisions.js +658 -658
  14. package/lib/dream/narratives.js +44 -0
  15. package/lib/dream/sleep.js +700 -700
  16. package/lib/dream.js +1319 -1216
  17. package/lib/embedding.js +177 -177
  18. package/lib/entities/extractor.js +249 -249
  19. package/lib/heat.js +142 -136
  20. package/lib/hot-memory.js +46 -46
  21. package/lib/index.js +515 -513
  22. package/lib/inject.js +299 -253
  23. package/lib/lang.js +202 -179
  24. package/lib/local-embedder.js +320 -308
  25. package/lib/mirror.js +198 -198
  26. package/lib/quality-filter.js +126 -126
  27. package/lib/recall-stats.js +103 -0
  28. package/lib/reranker.js +269 -260
  29. package/lib/runtime/adopt.js +176 -176
  30. package/lib/runtime/closure.js +172 -172
  31. package/lib/runtime/download.js +247 -247
  32. package/lib/runtime/layout.js +235 -235
  33. package/lib/runtime/loader.js +249 -249
  34. package/lib/runtime/model-fetch.js +361 -0
  35. package/lib/runtime/provision.js +237 -237
  36. package/lib/runtime/tarball.js +130 -130
  37. package/lib/runtime/verify.js +191 -191
  38. package/lib/scope.js +118 -118
  39. package/lib/search/adaptive.js +22 -22
  40. package/lib/search/bm25.js +96 -96
  41. package/lib/service.js +2171 -2071
  42. package/lib/settings.js +430 -419
  43. package/lib/store.js +2448 -2367
  44. package/lib/summarize.js +575 -449
  45. package/lib/tools.js +574 -574
  46. package/lib/vector-index.js +110 -110
  47. package/lib/version-check.js +122 -122
  48. package/package.json +109 -108
  49. package/runtime-manifest.json +596 -596
  50. package/scripts/benchmark-embed.js +201 -201
  51. package/scripts/benchmark-recall.js +199 -199
  52. package/scripts/benchmark-rerank.js +166 -166
  53. package/scripts/build-runtime-manifest.mjs +217 -217
  54. package/scripts/check-sync.js +42 -42
  55. package/scripts/e2e-dsh.js +220 -220
  56. package/scripts/mneme-runtime.mjs +277 -277
  57. package/scripts/stress-dsh.js +255 -255
  58. package/scripts/sync-lib.js +47 -47
  59. package/scripts/sync-test-badge.mjs +61 -61
  60. package/src/api-standalone.js +495 -316
  61. package/src/api.js +1382 -1316
  62. package/src/bootstrap.js +211 -0
  63. package/src/commands.js +95 -95
  64. package/src/config.js +533 -500
  65. package/src/dream/clustering.js +118 -118
  66. package/src/dream/decisions.js +658 -658
  67. package/src/dream/narratives.js +44 -0
  68. package/src/dream/sleep.js +700 -700
  69. package/src/dream.js +1319 -1216
  70. package/src/embedding.js +177 -177
  71. package/src/entities/extractor.js +249 -249
  72. package/src/heat.js +142 -136
  73. package/src/hot-memory.js +46 -46
  74. package/src/index.js +515 -513
  75. package/src/inject.js +299 -253
  76. package/src/lang.js +202 -179
  77. package/src/local-embedder.js +320 -308
  78. package/src/mirror.js +198 -198
  79. package/src/quality-filter.js +126 -126
  80. package/src/recall-stats.js +103 -0
  81. package/src/reranker.js +269 -260
  82. package/src/runtime/adopt.js +176 -176
  83. package/src/runtime/closure.js +172 -172
  84. package/src/runtime/download.js +247 -247
  85. package/src/runtime/layout.js +235 -235
  86. package/src/runtime/loader.js +249 -249
  87. package/src/runtime/model-fetch.js +361 -0
  88. package/src/runtime/provision.js +237 -237
  89. package/src/runtime/tarball.js +130 -130
  90. package/src/runtime/verify.js +191 -191
  91. package/src/scope.js +118 -118
  92. package/src/search/adaptive.js +22 -22
  93. package/src/search/bm25.js +96 -96
  94. package/src/service.js +2171 -2071
  95. package/src/settings.js +430 -419
  96. package/src/store.js +2448 -2367
  97. package/src/summarize.js +575 -449
  98. package/src/tools.js +574 -574
  99. package/src/vector-index.js +110 -110
  100. package/src/version-check.js +122 -122
  101. package/test/api-routes-gaps.test.js +218 -218
  102. package/test/api.test.js +1578 -1481
  103. package/test/audit.test.js +448 -448
  104. package/test/benchmark.test.js +94 -94
  105. package/test/bootstrap.test.js +220 -0
  106. package/test/client.test.js +799 -736
  107. package/test/clustering.test.js +100 -100
  108. package/test/commands.test.js +106 -106
  109. package/test/config.test.js +66 -66
  110. package/test/conflict-freeze.test.js +300 -300
  111. package/test/dream-archive-guardrail.test.js +116 -116
  112. package/test/dream-candidate-hybrid.test.js +281 -281
  113. package/test/dream-coverage-degrade.test.js +86 -86
  114. package/test/dream.test.js +1257 -1254
  115. package/test/embedding-ready.test.js +196 -196
  116. package/test/entities.test.js +547 -547
  117. package/test/entity-recall.test.js +179 -0
  118. package/test/epistemic.test.js +298 -298
  119. package/test/fnew-0112.test.js +311 -311
  120. package/test/fnew-03.test.js +422 -422
  121. package/test/graph-api.test.js +175 -175
  122. package/test/heat.test.js +175 -148
  123. package/test/helpers/dream-mock.js +82 -82
  124. package/test/helpers/peer-worker.mjs +25 -25
  125. package/test/helpers/runtime-source.js +60 -60
  126. package/test/helpers/tar-builder.js +80 -80
  127. package/test/hot-memory.test.js +145 -145
  128. package/test/inject-content-cap.test.js +89 -0
  129. package/test/inject-first-round-bm25.test.js +89 -89
  130. package/test/inject-heat.test.js +61 -0
  131. package/test/inject-rotation.test.js +161 -0
  132. package/test/inject.test.js +249 -249
  133. package/test/lang.test.js +87 -87
  134. package/test/lib-smoke.test.js +96 -96
  135. package/test/llm-audit.test.js +309 -309
  136. package/test/llm-message-source.test.js +177 -177
  137. package/test/local-embedder.test.js +249 -229
  138. package/test/mcp-stdio.test.js +385 -0
  139. package/test/mirror-dirty.test.js +424 -424
  140. package/test/mirror-edit-digest.test.js +187 -187
  141. package/test/mirror-generation.test.js +499 -499
  142. package/test/mirror.test.js +249 -249
  143. package/test/narrative-bars.test.js +162 -0
  144. package/test/peer-blockers.test.js +193 -193
  145. package/test/policy-epoch.test.js +259 -259
  146. package/test/quality-filter.test.js +186 -186
  147. package/test/reasoning-effort.test.js +746 -746
  148. package/test/recall-evals.test.js +235 -235
  149. package/test/recall-layer.test.js +326 -326
  150. package/test/recall-stats.test.js +117 -0
  151. package/test/receipt-chain.test.js +451 -451
  152. package/test/reflection.test.js +226 -226
  153. package/test/reindex-backfill.test.js +62 -62
  154. package/test/reranker-single-logit.test.js +73 -73
  155. package/test/reranker.test.js +197 -197
  156. package/test/resident-status.test.js +83 -0
  157. package/test/runtime-adopt.test.js +206 -206
  158. package/test/runtime-cli.test.js +89 -89
  159. package/test/runtime-closure.test.js +193 -193
  160. package/test/runtime-download.test.js +302 -302
  161. package/test/runtime-layout.test.js +163 -163
  162. package/test/runtime-loader.test.js +237 -237
  163. package/test/runtime-manifest.test.js +158 -158
  164. package/test/runtime-model-fetch.test.js +348 -0
  165. package/test/runtime-provision.test.js +101 -101
  166. package/test/runtime-tarball.test.js +81 -81
  167. package/test/runtime-verify.test.js +214 -214
  168. package/test/scope-candidates.test.js +239 -239
  169. package/test/scope-explicit.test.js +452 -452
  170. package/test/scope-retrieval.test.js +197 -197
  171. package/test/scope-storage.test.js +255 -255
  172. package/test/scope-strict.test.js +231 -231
  173. package/test/search-fusion.test.js +90 -90
  174. package/test/semantic.test.js +124 -124
  175. package/test/service-search.test.js +174 -174
  176. package/test/service.test.js +405 -405
  177. package/test/settings.test.js +261 -261
  178. package/test/skip-invalid-restore.test.js +262 -262
  179. package/test/sleep-action-set.test.js +422 -422
  180. package/test/sleep-heat.test.js +126 -125
  181. package/test/sleep-scheduler-rearm.test.js +89 -89
  182. package/test/sleep.test.js +373 -373
  183. package/test/standalone-api.test.js +544 -359
  184. package/test/store-vector-cache.test.js +98 -98
  185. package/test/store.test.js +383 -383
  186. package/test/stress.test.js +209 -209
  187. package/test/summarize.test.js +884 -575
  188. package/test/tools-memory-get-schema.test.js +65 -65
  189. package/test/tools.test.js +341 -341
  190. package/test/updated-at-semantics.test.js +113 -113
  191. package/test/vector-index.test.js +221 -221
  192. package/test/version-check.test.js +152 -152
  193. package/test/webServer-optional.test.js +82 -82
@@ -1,209 +1,209 @@
1
- import test from "node:test";
2
- import assert from "node:assert/strict";
3
- import { mkdtempSync } from "node:fs";
4
- import { tmpdir } from "node:os";
5
- import { join } from "node:path";
6
- import { createStore } from "../src/store.js";
7
- import { createService } from "../src/service.js";
8
- import { createDreamScheduler, parseReceipt } from "../src/dream.js";
9
- import { applyDecisions } from "../src/dream/decisions.js";
10
- import {
11
- sessionDecisions,
12
- arbitrationDecisions,
13
- mockCtx
14
- } from "./helpers/dream-mock.js";
15
-
16
- function setup() {
17
- const store = createStore(":memory:");
18
- const service = createService({ store, mirror: null, config: {} });
19
- const dream = createDreamScheduler({ onRun: () => Promise.resolve({ ok: true, skipped: true }) });
20
- return { store, service, dream };
21
- }
22
-
23
- function tmpPath(prefix) {
24
- return join(mkdtempSync(join(tmpdir(), prefix)), "memory.db");
25
- }
26
-
27
- // ---------------------------------------------------------------- 轴线 1
28
-
29
- test("long-session stress: Recall@k stays high, stale residual drops to zero", async () => {
30
- const { store, service, dream } = setup();
31
- const ctx = mockCtx({ onConsolidation: sessionDecisions });
32
- const topics = 5;
33
- const rounds = 3;
34
-
35
- const gt = [];
36
- for (let t = 1; t <= topics; t++) {
37
- const title = `主题${String(t).padStart(2, "0")}`;
38
- const { memory } = service.saveWithDedupe({ type: "project", title, content: `${title} 规范内容`, importance: 5 });
39
- gt.push({ title, id: memory.id });
40
- }
41
- for (let r = 1; r <= rounds; r++) {
42
- for (let t = 1; t <= topics; t++) {
43
- service.saveWithDedupe({
44
- type: "project",
45
- title: `主题${String(t).padStart(2, "0")}·变体${r}`,
46
- content: "旧变体",
47
- importance: 3
48
- });
49
- }
50
- const result = await dream.runDream(ctx, service, {});
51
- assert.equal(result.ok, true);
52
- }
53
-
54
- let hits = 0;
55
- for (const { title, id } of gt) {
56
- if (service.search(title, { limit: 5 }).some((m) => m.id === id)) hits++;
57
- }
58
- assert.equal(hits, topics, "every canonical memory recalled in top-5 after 3 consolidation rounds");
59
-
60
- const all = store.all();
61
- const variants = all.filter((m) => m.type === "project" && m.title.includes("变体"));
62
- assert.equal(variants.filter((m) => !m.archived).length, 0, "no stale variants remain active");
63
- assert.equal(store.listDreamRuns().length, rounds, "every run written to the audit trail");
64
- store.close();
65
- });
66
-
67
- // ---------------------------------------------------------------- 轴线 2
68
-
69
- test("arbitration set is replayable: deterministic, correct, idempotent replay", async () => {
70
- const { store, service, dream } = setup();
71
- const ctx = mockCtx({ onConsolidation: arbitrationDecisions });
72
- const sets = [
73
- { w: { type: "decision", title: "截止", content: "8月20日", importance: 5 }, l: { type: "decision", title: "截止(旧)", content: "8月15日", importance: 3 } },
74
- { w: { type: "preference", title: "语言", content: "简体中文", importance: 5 }, l: { type: "preference", title: "语言(旧)", content: "繁体中文", importance: 2 } }
75
- ];
76
- for (const s of sets) {
77
- service.saveWithDedupe({ ...s.l });
78
- service.saveWithDedupe({ ...s.w });
79
- }
80
-
81
- const run = await dream.runDream(ctx, service, {});
82
- assert.equal(run.ok, true);
83
- assert.equal(run.applied, sets.length, "one conflict per arbitration set");
84
-
85
- // correctness: winner kept (with provenance), loser archived
86
- for (const s of sets) {
87
- const winner = service.list({ type: s.w.type }).find((m) => m.title === s.w.title);
88
- const loser = store.all().find((m) => m.title === s.l.title);
89
- assert.ok(winner, "winner present");
90
- assert.ok(loser?.archived, "loser archived");
91
- assert.ok(winner.content.includes("已否决旧信息"), "provenance note appended");
92
- }
93
-
94
- // audit + receipt are replayable
95
- const audit = store.getDreamRun(run.runId);
96
- assert.equal(audit.status, "ok");
97
- const receipt = parseReceipt(audit.receipt);
98
- assert.equal(receipt.status, "ok");
99
- assert.equal(Object.keys(audit.outcome.byId).length, sets.length * 2, "outcome covers every arbitrated id");
100
- assert.equal(audit.decisions.length, sets.length, "raw decisions persisted");
101
-
102
- // re-applying the recorded decision list is a no-op (idempotent replay)
103
- assert.equal(applyDecisions(audit.decisions, service).applied, 0, "replay applies nothing");
104
- store.close();
105
- });
106
-
107
- // ---------------------------------------------------------------- 轴线 3
108
-
109
- function bump(content) {
110
- return `count=${Number(content.match(/count=(\d+)/)[1]) + 1}`;
111
- }
112
-
113
- test("concurrent agents: no duplicate merge, lost-update reproduced then fixed, crash recovery", () => {
114
- const path = tmpPath("dsh-mneme-stress-test-");
115
- const sA = createStore(path);
116
- const svA = createService({ store: sA, mirror: null, config: {} });
117
-
118
- // duplicate merge: 20 agents save the same title → exactly one active row
119
- for (let i = 0; i < 20; i++) {
120
- svA.saveWithDedupe({ type: "preference", title: "并发任务", content: `agent-${i}` });
121
- }
122
- assert.equal(
123
- svA.list({ type: "preference", limit: 100 }).filter((m) => m.title === "并发任务").length,
124
- 1,
125
- "no duplicate rows after concurrent same-title saves"
126
- );
127
-
128
- // lost update: two connections read the same baseline, then both write
129
- const sB = createStore(path);
130
- const svB = createService({ store: sB, mirror: null, config: {} });
131
- svA.saveWithDedupe({ type: "history", title: "计数器", content: "count=0", importance: 3 });
132
- const id = svA.list({ type: "history" })[0].id;
133
-
134
- const readA = svA.getById(id).content; // count=0
135
- const readB = svB.getById(id).content; // count=0 (stale)
136
- svA.update(id, { content: bump(readA) }); // count=1
137
- svB.update(id, { content: bump(readB) }); // count=1 → overwrites A's increment
138
- assert.equal(svB.getById(id).content, "count=1", "unlocked read-modify-write loses an increment");
139
-
140
- // serialized fix: re-read the latest value before writing
141
- svA.update(id, { content: "count=0" });
142
- svA.update(id, { content: bump(svA.getById(id).content) }); // reads 0 → 1
143
- svB.update(id, { content: bump(svB.getById(id).content) }); // reads 1 → 2
144
- assert.equal(svB.getById(id).content, "count=2", "re-read before write keeps both increments");
145
-
146
- // crash recovery: committed writes survive an exception and a reopen
147
- svA.saveWithDedupe({ type: "project", title: "已提交", content: "x" });
148
- assert.throws(() => svA.update("ghost", { content: "boom" }), /not found/, "unknown-id update throws");
149
- sA.close();
150
- sB.close();
151
-
152
- const sR = createStore(path);
153
- assert.ok(sR.getById(id), "counter survives reopen");
154
- assert.ok(sR.all().some((m) => m.title === "已提交"), "committed write survives reopen");
155
- assert.equal(sR.all().filter((m) => m.title === "已提交").length, 1, "no partial residue");
156
- sR.close();
157
- });
158
-
159
- // ---------------------------------------------------------------- CAS + atomicity (item ③)
160
-
161
- test("CAS concurrent increments: stale version rejected, retry lands both increments", () => {
162
- const path = tmpPath("dsh-mneme-stress-cas-");
163
- const sA = createStore(path);
164
- const svA = createService({ store: sA, mirror: null, config: {} });
165
- const sB = createStore(path);
166
- const svB = createService({ store: sB, mirror: null, config: {} });
167
-
168
- svA.saveWithDedupe({ type: "history", title: "计数器", content: "count=0", importance: 3 });
169
- const id = svA.list({ type: "history" })[0].id;
170
- svA.update(id, { content: "count=0" });
171
- const baseline = svA.getById(id); // updated_at=T, count=0
172
-
173
- const aOk = svA.compareAndUpdate(id, baseline.updated_at, { content: bump("count=0") });
174
- assert.ok(aOk, "current-version CAS lands");
175
- const bStale = svB.compareAndUpdate(id, baseline.updated_at, { content: bump("count=0") });
176
- assert.equal(bStale, undefined, "stale-version CAS rejected — no lost update");
177
-
178
- const cur = svB.getById(id);
179
- svB.compareAndUpdate(id, cur.updated_at, { content: bump(cur.content) });
180
- assert.equal(svB.getById(id).content, "count=2", "re-read + retry keeps both increments");
181
- sA.close();
182
- sB.close();
183
- });
184
-
185
- test("multi-step transaction is atomic: a mid-way throw rolls back every step", () => {
186
- const path = tmpPath("dsh-mneme-stress-atomic-");
187
- const s = createStore(path);
188
- const sv = createService({ store: s, mirror: null, config: {} });
189
-
190
- assert.throws(
191
- () => sv.transaction(() => {
192
- sv.saveWithDedupe({ type: "project", title: "原子A", content: "x" });
193
- sv.saveWithDedupe({ type: "project", title: "原子B", content: "y" });
194
- throw new Error("boom");
195
- }),
196
- /boom/
197
- );
198
- assert.ok(!s.all().some((m) => m.title === "原子A"), "atomicA fully rolled back");
199
- assert.ok(!s.all().some((m) => m.title === "原子B"), "atomicB fully rolled back");
200
-
201
- // a clean transaction commits both steps
202
- sv.transaction(() => {
203
- sv.saveWithDedupe({ type: "project", title: "完整A", content: "x" });
204
- sv.saveWithDedupe({ type: "project", title: "完整B", content: "y" });
205
- });
206
- assert.equal(s.all().filter((m) => m.title === "完整A").length, 1, "committed step A");
207
- assert.equal(s.all().filter((m) => m.title === "完整B").length, 1, "committed step B");
208
- s.close();
209
- });
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import { mkdtempSync } from "node:fs";
4
+ import { tmpdir } from "node:os";
5
+ import { join } from "node:path";
6
+ import { createStore } from "../src/store.js";
7
+ import { createService } from "../src/service.js";
8
+ import { createDreamScheduler, parseReceipt } from "../src/dream.js";
9
+ import { applyDecisions } from "../src/dream/decisions.js";
10
+ import {
11
+ sessionDecisions,
12
+ arbitrationDecisions,
13
+ mockCtx
14
+ } from "./helpers/dream-mock.js";
15
+
16
+ function setup() {
17
+ const store = createStore(":memory:");
18
+ const service = createService({ store, mirror: null, config: {} });
19
+ const dream = createDreamScheduler({ onRun: () => Promise.resolve({ ok: true, skipped: true }) });
20
+ return { store, service, dream };
21
+ }
22
+
23
+ function tmpPath(prefix) {
24
+ return join(mkdtempSync(join(tmpdir(), prefix)), "memory.db");
25
+ }
26
+
27
+ // ---------------------------------------------------------------- 轴线 1
28
+
29
+ test("long-session stress: Recall@k stays high, stale residual drops to zero", async () => {
30
+ const { store, service, dream } = setup();
31
+ const ctx = mockCtx({ onConsolidation: sessionDecisions });
32
+ const topics = 5;
33
+ const rounds = 3;
34
+
35
+ const gt = [];
36
+ for (let t = 1; t <= topics; t++) {
37
+ const title = `主题${String(t).padStart(2, "0")}`;
38
+ const { memory } = service.saveWithDedupe({ type: "project", title, content: `${title} 规范内容`, importance: 5 });
39
+ gt.push({ title, id: memory.id });
40
+ }
41
+ for (let r = 1; r <= rounds; r++) {
42
+ for (let t = 1; t <= topics; t++) {
43
+ service.saveWithDedupe({
44
+ type: "project",
45
+ title: `主题${String(t).padStart(2, "0")}·变体${r}`,
46
+ content: "旧变体",
47
+ importance: 3
48
+ });
49
+ }
50
+ const result = await dream.runDream(ctx, service, {});
51
+ assert.equal(result.ok, true);
52
+ }
53
+
54
+ let hits = 0;
55
+ for (const { title, id } of gt) {
56
+ if (service.search(title, { limit: 5 }).some((m) => m.id === id)) hits++;
57
+ }
58
+ assert.equal(hits, topics, "every canonical memory recalled in top-5 after 3 consolidation rounds");
59
+
60
+ const all = store.all();
61
+ const variants = all.filter((m) => m.type === "project" && m.title.includes("变体"));
62
+ assert.equal(variants.filter((m) => !m.archived).length, 0, "no stale variants remain active");
63
+ assert.equal(store.listDreamRuns().length, rounds, "every run written to the audit trail");
64
+ store.close();
65
+ });
66
+
67
+ // ---------------------------------------------------------------- 轴线 2
68
+
69
+ test("arbitration set is replayable: deterministic, correct, idempotent replay", async () => {
70
+ const { store, service, dream } = setup();
71
+ const ctx = mockCtx({ onConsolidation: arbitrationDecisions });
72
+ const sets = [
73
+ { w: { type: "decision", title: "截止", content: "8月20日", importance: 5 }, l: { type: "decision", title: "截止(旧)", content: "8月15日", importance: 3 } },
74
+ { w: { type: "preference", title: "语言", content: "简体中文", importance: 5 }, l: { type: "preference", title: "语言(旧)", content: "繁体中文", importance: 2 } }
75
+ ];
76
+ for (const s of sets) {
77
+ service.saveWithDedupe({ ...s.l });
78
+ service.saveWithDedupe({ ...s.w });
79
+ }
80
+
81
+ const run = await dream.runDream(ctx, service, {});
82
+ assert.equal(run.ok, true);
83
+ assert.equal(run.applied, sets.length, "one conflict per arbitration set");
84
+
85
+ // correctness: winner kept (with provenance), loser archived
86
+ for (const s of sets) {
87
+ const winner = service.list({ type: s.w.type }).find((m) => m.title === s.w.title);
88
+ const loser = store.all().find((m) => m.title === s.l.title);
89
+ assert.ok(winner, "winner present");
90
+ assert.ok(loser?.archived, "loser archived");
91
+ assert.ok(winner.content.includes("已否决旧信息"), "provenance note appended");
92
+ }
93
+
94
+ // audit + receipt are replayable
95
+ const audit = store.getDreamRun(run.runId);
96
+ assert.equal(audit.status, "ok");
97
+ const receipt = parseReceipt(audit.receipt);
98
+ assert.equal(receipt.status, "ok");
99
+ assert.equal(Object.keys(audit.outcome.byId).length, sets.length * 2, "outcome covers every arbitrated id");
100
+ assert.equal(audit.decisions.length, sets.length, "raw decisions persisted");
101
+
102
+ // re-applying the recorded decision list is a no-op (idempotent replay)
103
+ assert.equal(applyDecisions(audit.decisions, service).applied, 0, "replay applies nothing");
104
+ store.close();
105
+ });
106
+
107
+ // ---------------------------------------------------------------- 轴线 3
108
+
109
+ function bump(content) {
110
+ return `count=${Number(content.match(/count=(\d+)/)[1]) + 1}`;
111
+ }
112
+
113
+ test("concurrent agents: no duplicate merge, lost-update reproduced then fixed, crash recovery", () => {
114
+ const path = tmpPath("dsh-mneme-stress-test-");
115
+ const sA = createStore(path);
116
+ const svA = createService({ store: sA, mirror: null, config: {} });
117
+
118
+ // duplicate merge: 20 agents save the same title → exactly one active row
119
+ for (let i = 0; i < 20; i++) {
120
+ svA.saveWithDedupe({ type: "preference", title: "并发任务", content: `agent-${i}` });
121
+ }
122
+ assert.equal(
123
+ svA.list({ type: "preference", limit: 100 }).filter((m) => m.title === "并发任务").length,
124
+ 1,
125
+ "no duplicate rows after concurrent same-title saves"
126
+ );
127
+
128
+ // lost update: two connections read the same baseline, then both write
129
+ const sB = createStore(path);
130
+ const svB = createService({ store: sB, mirror: null, config: {} });
131
+ svA.saveWithDedupe({ type: "history", title: "计数器", content: "count=0", importance: 3 });
132
+ const id = svA.list({ type: "history" })[0].id;
133
+
134
+ const readA = svA.getById(id).content; // count=0
135
+ const readB = svB.getById(id).content; // count=0 (stale)
136
+ svA.update(id, { content: bump(readA) }); // count=1
137
+ svB.update(id, { content: bump(readB) }); // count=1 → overwrites A's increment
138
+ assert.equal(svB.getById(id).content, "count=1", "unlocked read-modify-write loses an increment");
139
+
140
+ // serialized fix: re-read the latest value before writing
141
+ svA.update(id, { content: "count=0" });
142
+ svA.update(id, { content: bump(svA.getById(id).content) }); // reads 0 → 1
143
+ svB.update(id, { content: bump(svB.getById(id).content) }); // reads 1 → 2
144
+ assert.equal(svB.getById(id).content, "count=2", "re-read before write keeps both increments");
145
+
146
+ // crash recovery: committed writes survive an exception and a reopen
147
+ svA.saveWithDedupe({ type: "project", title: "已提交", content: "x" });
148
+ assert.throws(() => svA.update("ghost", { content: "boom" }), /not found/, "unknown-id update throws");
149
+ sA.close();
150
+ sB.close();
151
+
152
+ const sR = createStore(path);
153
+ assert.ok(sR.getById(id), "counter survives reopen");
154
+ assert.ok(sR.all().some((m) => m.title === "已提交"), "committed write survives reopen");
155
+ assert.equal(sR.all().filter((m) => m.title === "已提交").length, 1, "no partial residue");
156
+ sR.close();
157
+ });
158
+
159
+ // ---------------------------------------------------------------- CAS + atomicity (item ③)
160
+
161
+ test("CAS concurrent increments: stale version rejected, retry lands both increments", () => {
162
+ const path = tmpPath("dsh-mneme-stress-cas-");
163
+ const sA = createStore(path);
164
+ const svA = createService({ store: sA, mirror: null, config: {} });
165
+ const sB = createStore(path);
166
+ const svB = createService({ store: sB, mirror: null, config: {} });
167
+
168
+ svA.saveWithDedupe({ type: "history", title: "计数器", content: "count=0", importance: 3 });
169
+ const id = svA.list({ type: "history" })[0].id;
170
+ svA.update(id, { content: "count=0" });
171
+ const baseline = svA.getById(id); // updated_at=T, count=0
172
+
173
+ const aOk = svA.compareAndUpdate(id, baseline.updated_at, { content: bump("count=0") });
174
+ assert.ok(aOk, "current-version CAS lands");
175
+ const bStale = svB.compareAndUpdate(id, baseline.updated_at, { content: bump("count=0") });
176
+ assert.equal(bStale, undefined, "stale-version CAS rejected — no lost update");
177
+
178
+ const cur = svB.getById(id);
179
+ svB.compareAndUpdate(id, cur.updated_at, { content: bump(cur.content) });
180
+ assert.equal(svB.getById(id).content, "count=2", "re-read + retry keeps both increments");
181
+ sA.close();
182
+ sB.close();
183
+ });
184
+
185
+ test("multi-step transaction is atomic: a mid-way throw rolls back every step", () => {
186
+ const path = tmpPath("dsh-mneme-stress-atomic-");
187
+ const s = createStore(path);
188
+ const sv = createService({ store: s, mirror: null, config: {} });
189
+
190
+ assert.throws(
191
+ () => sv.transaction(() => {
192
+ sv.saveWithDedupe({ type: "project", title: "原子A", content: "x" });
193
+ sv.saveWithDedupe({ type: "project", title: "原子B", content: "y" });
194
+ throw new Error("boom");
195
+ }),
196
+ /boom/
197
+ );
198
+ assert.ok(!s.all().some((m) => m.title === "原子A"), "atomicA fully rolled back");
199
+ assert.ok(!s.all().some((m) => m.title === "原子B"), "atomicB fully rolled back");
200
+
201
+ // a clean transaction commits both steps
202
+ sv.transaction(() => {
203
+ sv.saveWithDedupe({ type: "project", title: "完整A", content: "x" });
204
+ sv.saveWithDedupe({ type: "project", title: "完整B", content: "y" });
205
+ });
206
+ assert.equal(s.all().filter((m) => m.title === "完整A").length, 1, "committed step A");
207
+ assert.equal(s.all().filter((m) => m.title === "完整B").length, 1, "committed step B");
208
+ s.close();
209
+ });