@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,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
+ });