@modusensus/dsh-mneme 0.8.14 → 0.8.15

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 (271) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +655 -654
  3. package/assets/icon.svg +3 -3
  4. package/bin/cli.mjs +689 -689
  5. package/bin/dsh-mneme-mcp.mjs +510 -510
  6. package/bin/dsh-mneme-serve.mjs +151 -151
  7. package/cordis.patch.yml +21 -21
  8. package/docs/CONFIGURATION.md +263 -0
  9. package/docs/CONTINUITY.md +124 -0
  10. package/docs/DAEMON.md +46 -0
  11. package/docs/ENTITIES.md +245 -0
  12. package/docs/LOCAL_MODEL.md +222 -0
  13. package/docs/SEMANTIC.md +256 -0
  14. package/docs/SLEEP.md +164 -0
  15. package/docs/STORAGE.md +89 -0
  16. package/lib/api-standalone.js +673 -673
  17. package/lib/api.js +1437 -1433
  18. package/lib/bootstrap.js +211 -211
  19. package/lib/client.js +5444 -5295
  20. package/lib/commands.js +95 -95
  21. package/lib/config.js +880 -843
  22. package/lib/content-hash.js +54 -54
  23. package/lib/continuity.js +220 -220
  24. package/lib/document-index.js +94 -94
  25. package/lib/document.js +303 -303
  26. package/lib/dream/clustering.js +118 -118
  27. package/lib/dream/decisions.js +674 -674
  28. package/lib/dream/narratives.js +44 -44
  29. package/lib/dream/sleep.js +819 -819
  30. package/lib/dream.js +1501 -1501
  31. package/lib/embedding.js +177 -177
  32. package/lib/entities/extractor.js +252 -252
  33. package/lib/graph/anchoring.js +179 -179
  34. package/lib/guide.js +74 -74
  35. package/lib/heat.js +144 -144
  36. package/lib/hot-memory.js +46 -46
  37. package/lib/index.js +535 -503
  38. package/lib/inject.js +464 -450
  39. package/lib/lang.js +248 -229
  40. package/lib/local-embedder.js +358 -358
  41. package/lib/maintenance.js +142 -142
  42. package/lib/mirror.js +330 -330
  43. package/lib/organize.js +450 -450
  44. package/lib/peak-hours.js +117 -117
  45. package/lib/placement.js +13 -0
  46. package/lib/pre-inject-gate.js +340 -0
  47. package/lib/quality-filter.js +126 -126
  48. package/lib/recall-stats.js +175 -175
  49. package/lib/reranker.js +269 -269
  50. package/lib/runtime/adopt.js +176 -176
  51. package/lib/runtime/closure.js +172 -172
  52. package/lib/runtime/download.js +247 -247
  53. package/lib/runtime/layout.js +265 -265
  54. package/lib/runtime/loader.js +252 -252
  55. package/lib/runtime/model-fetch.js +361 -361
  56. package/lib/runtime/provision.js +237 -237
  57. package/lib/runtime/tarball.js +130 -130
  58. package/lib/runtime/verify.js +223 -204
  59. package/lib/scope.js +146 -146
  60. package/lib/search/adaptive.js +60 -60
  61. package/lib/search/bm25.js +96 -96
  62. package/lib/semantic.js +229 -229
  63. package/lib/sensitive-scan.js +209 -209
  64. package/lib/serve.js +215 -215
  65. package/lib/service.js +2663 -2605
  66. package/lib/settings.js +517 -511
  67. package/lib/store.js +3007 -3007
  68. package/lib/summarize.js +891 -856
  69. package/lib/tools.js +743 -737
  70. package/lib/vector-index.js +110 -110
  71. package/lib/version-check.js +122 -122
  72. package/lib/write-admission.js +402 -402
  73. package/locale/en.json +6 -6
  74. package/locale/zh.json +6 -6
  75. package/package.json +118 -118
  76. package/runtime-manifest.json +526 -526
  77. package/scripts/benchmark-embed.js +201 -201
  78. package/scripts/benchmark-recall.js +249 -249
  79. package/scripts/benchmark-rerank.js +166 -166
  80. package/scripts/build-runtime-manifest.mjs +224 -224
  81. package/scripts/changelog-prep.mjs +36 -36
  82. package/scripts/check-sync.js +42 -42
  83. package/scripts/e2e-dsh.js +220 -220
  84. package/scripts/mneme-runtime.mjs +277 -277
  85. package/scripts/stress-dsh.js +255 -255
  86. package/scripts/sync-lib.js +47 -47
  87. package/scripts/sync-test-badge.mjs +69 -69
  88. package/scripts/test-count-sync.mjs +44 -44
  89. package/src/api-standalone.js +673 -673
  90. package/src/api.js +1437 -1433
  91. package/src/bootstrap.js +211 -211
  92. package/src/commands.js +95 -95
  93. package/src/config.js +880 -843
  94. package/src/content-hash.js +54 -54
  95. package/src/continuity.js +220 -220
  96. package/src/document-index.js +94 -94
  97. package/src/document.js +303 -303
  98. package/src/dream/clustering.js +118 -118
  99. package/src/dream/decisions.js +674 -674
  100. package/src/dream/narratives.js +44 -44
  101. package/src/dream/sleep.js +819 -819
  102. package/src/dream.js +1501 -1501
  103. package/src/embedding.js +177 -177
  104. package/src/entities/extractor.js +252 -252
  105. package/src/graph/anchoring.js +179 -179
  106. package/src/guide.js +74 -74
  107. package/src/heat.js +144 -144
  108. package/src/hot-memory.js +46 -46
  109. package/src/index.js +535 -503
  110. package/src/inject.js +464 -450
  111. package/src/lang.js +248 -229
  112. package/src/local-embedder.js +358 -358
  113. package/src/maintenance.js +142 -142
  114. package/src/mirror.js +330 -330
  115. package/src/organize.js +450 -450
  116. package/src/peak-hours.js +117 -117
  117. package/src/placement.js +13 -0
  118. package/src/pre-inject-gate.js +340 -0
  119. package/src/quality-filter.js +126 -126
  120. package/src/recall-stats.js +175 -175
  121. package/src/reranker.js +269 -269
  122. package/src/runtime/adopt.js +176 -176
  123. package/src/runtime/closure.js +172 -172
  124. package/src/runtime/download.js +247 -247
  125. package/src/runtime/layout.js +265 -265
  126. package/src/runtime/loader.js +252 -252
  127. package/src/runtime/model-fetch.js +361 -361
  128. package/src/runtime/provision.js +237 -237
  129. package/src/runtime/tarball.js +130 -130
  130. package/src/runtime/verify.js +223 -204
  131. package/src/scope.js +146 -146
  132. package/src/search/adaptive.js +60 -60
  133. package/src/search/bm25.js +96 -96
  134. package/src/semantic.js +229 -229
  135. package/src/sensitive-scan.js +209 -209
  136. package/src/serve.js +215 -215
  137. package/src/service.js +2663 -2605
  138. package/src/settings.js +517 -511
  139. package/src/store.js +3007 -3007
  140. package/src/summarize.js +891 -856
  141. package/src/tools.js +743 -737
  142. package/src/vector-index.js +110 -110
  143. package/src/version-check.js +122 -122
  144. package/src/write-admission.js +402 -402
  145. package/test/adaptive-inject-budget.test.js +85 -85
  146. package/test/api-routes-gaps.test.js +218 -218
  147. package/test/api.test.js +1702 -1690
  148. package/test/audit.test.js +448 -448
  149. package/test/baseline-persist.test.js +248 -248
  150. package/test/benchmark.test.js +94 -94
  151. package/test/bootstrap.test.js +220 -220
  152. package/test/changelog-prep.test.js +60 -60
  153. package/test/client.test.js +1230 -1169
  154. package/test/clustering.test.js +100 -100
  155. package/test/commands.test.js +106 -106
  156. package/test/config.test.js +66 -66
  157. package/test/conflict-freeze.test.js +300 -300
  158. package/test/content-hash.test.js +204 -204
  159. package/test/continuity.test.js +333 -333
  160. package/test/document-dir.test.js +233 -233
  161. package/test/document.test.js +671 -671
  162. package/test/dream-archive-guardrail.test.js +116 -116
  163. package/test/dream-candidate-hybrid.test.js +281 -281
  164. package/test/dream-coverage-degrade.test.js +86 -86
  165. package/test/dream-failure-backoff.test.js +173 -173
  166. package/test/dream-peak-hours.test.js +194 -194
  167. package/test/dream.test.js +1385 -1383
  168. package/test/embedding-ready.test.js +196 -196
  169. package/test/entities.test.js +627 -547
  170. package/test/entity-recall.test.js +179 -179
  171. package/test/epistemic.test.js +325 -325
  172. package/test/fnew-0112.test.js +311 -311
  173. package/test/fnew-03.test.js +422 -422
  174. package/test/graph-anchoring.test.js +184 -184
  175. package/test/graph-api.test.js +175 -175
  176. package/test/graph-inject-budget.test.js +103 -103
  177. package/test/graph-passive-confirm.test.js +91 -91
  178. package/test/graph-weight-evolution.test.js +104 -104
  179. package/test/heat.test.js +175 -175
  180. package/test/helpers/dream-mock.js +82 -82
  181. package/test/helpers/peer-worker.mjs +25 -25
  182. package/test/helpers/runtime-source.js +60 -60
  183. package/test/helpers/tar-builder.js +80 -80
  184. package/test/helpers/write-admission-samples.js +308 -308
  185. package/test/hot-memory.test.js +145 -145
  186. package/test/inject-content-cap.test.js +91 -91
  187. package/test/inject-first-round-bm25.test.js +89 -89
  188. package/test/inject-heat.test.js +77 -77
  189. package/test/inject-parent-gate.test.js +106 -106
  190. package/test/inject-pools.test.js +194 -194
  191. package/test/inject-recall.test.js +105 -105
  192. package/test/inject-rotation.test.js +161 -161
  193. package/test/inject.test.js +420 -420
  194. package/test/lang.test.js +87 -87
  195. package/test/lastrunat-persist.test.js +101 -101
  196. package/test/lib-smoke.test.js +96 -96
  197. package/test/llm-audit.test.js +598 -598
  198. package/test/llm-message-source.test.js +207 -207
  199. package/test/local-embedder.test.js +292 -292
  200. package/test/maintenance.test.js +391 -391
  201. package/test/mcp-stdio.test.js +385 -385
  202. package/test/mirror-dirty.test.js +424 -424
  203. package/test/mirror-edit-digest.test.js +187 -187
  204. package/test/mirror-generation.test.js +499 -499
  205. package/test/mirror-types.test.js +208 -208
  206. package/test/mirror.test.js +249 -249
  207. package/test/narrative-bars.test.js +162 -162
  208. package/test/organize.test.js +418 -418
  209. package/test/peer-blockers.test.js +193 -193
  210. package/test/placement.test.js +36 -0
  211. package/test/policy-epoch.test.js +259 -259
  212. package/test/pre-inject-gate.test.js +434 -0
  213. package/test/quality-filter.test.js +186 -186
  214. package/test/reasoning-effort.test.js +752 -752
  215. package/test/recall-anti-update.test.js +82 -82
  216. package/test/recall-evals.test.js +253 -253
  217. package/test/recall-layer.test.js +326 -326
  218. package/test/recall-stats.test.js +189 -189
  219. package/test/receipt-chain.test.js +451 -451
  220. package/test/reflection.test.js +226 -226
  221. package/test/reindex-backfill.test.js +62 -62
  222. package/test/reranker-single-logit.test.js +73 -73
  223. package/test/reranker.test.js +197 -197
  224. package/test/resident-status.test.js +83 -83
  225. package/test/runtime-adopt.test.js +206 -206
  226. package/test/runtime-cli.test.js +89 -89
  227. package/test/runtime-closure.test.js +193 -193
  228. package/test/runtime-download.test.js +302 -302
  229. package/test/runtime-layout.test.js +163 -163
  230. package/test/runtime-loader.test.js +255 -255
  231. package/test/runtime-manifest.test.js +159 -159
  232. package/test/runtime-model-fetch.test.js +348 -348
  233. package/test/runtime-provision.test.js +101 -101
  234. package/test/runtime-tarball.test.js +81 -81
  235. package/test/runtime-verify.test.js +319 -279
  236. package/test/scope-candidates.test.js +239 -239
  237. package/test/scope-explicit.test.js +452 -452
  238. package/test/scope-inject-soft.test.js +106 -106
  239. package/test/scope-retrieval.test.js +197 -197
  240. package/test/scope-storage.test.js +255 -255
  241. package/test/scope-strict.test.js +367 -367
  242. package/test/search-fusion.test.js +90 -90
  243. package/test/semantic.test.js +124 -124
  244. package/test/sensitive-scan.test.js +207 -207
  245. package/test/serve-bin.test.js +121 -121
  246. package/test/serve.test.js +196 -196
  247. package/test/service-search.test.js +174 -174
  248. package/test/service.test.js +405 -405
  249. package/test/settings.test.js +261 -261
  250. package/test/skip-invalid-restore.test.js +262 -262
  251. package/test/sleep-action-set.test.js +422 -422
  252. package/test/sleep-heat.test.js +126 -126
  253. package/test/sleep-scheduler-rearm.test.js +89 -89
  254. package/test/sleep.test.js +527 -527
  255. package/test/standalone-api.test.js +751 -751
  256. package/test/store-vector-cache.test.js +98 -98
  257. package/test/store.test.js +396 -396
  258. package/test/stress.test.js +209 -209
  259. package/test/summarize-occurred-at.test.js +127 -0
  260. package/test/summarize-reasoning-effort.test.js +189 -189
  261. package/test/summarize.test.js +1465 -1465
  262. package/test/supersede-state-tracking.test.js +394 -0
  263. package/test/test-count-sync.test.js +60 -60
  264. package/test/tools-dto-schema-matrix.test.js +325 -325
  265. package/test/tools-memory-get-schema.test.js +65 -65
  266. package/test/tools.test.js +428 -374
  267. package/test/updated-at-semantics.test.js +113 -113
  268. package/test/vector-index.test.js +221 -221
  269. package/test/version-check.test.js +152 -152
  270. package/test/webServer-optional.test.js +82 -82
  271. package/test/write-admission.test.js +668 -668
@@ -1,255 +1,255 @@
1
- // scripts/stress-dsh.js
2
- // 压测:沿着三条轴线检验 dsh-mneme 的 autoDream 与存储在长会话、冲突、
3
- // 并发压力下的表现。LLM 全部用确定性的 mock 决策,离线可跑、无需 API Key。
4
- //
5
- // 轴线 1 · 长会话检索:Recall@k(规范记忆能否被召回)与陈旧残留率
6
- // 轴线 2 · 冲突裁决:可重放仲裁集 —— 仲裁正确率、确定性、审计/回放
7
- // 轴线 3 · 多 Agent 并发:丢更新、重复合并、事务/崩溃恢复
8
- //
9
- // 运行:node scripts/stress-dsh.js
10
- import { mkdtempSync } from "node:fs";
11
- import { tmpdir } from "node:os";
12
- import { join } from "node:path";
13
- import { createStore } from "../src/store.js";
14
- import { createService } from "../src/service.js";
15
- import {
16
- createDreamScheduler,
17
- hashSnapshot,
18
- parseReceipt
19
- } from "../src/dream.js";
20
- import { applyDecisions } from "../src/dream/decisions.js";
21
- import {
22
- sessionDecisions,
23
- arbitrationDecisions,
24
- mockCtx
25
- } from "../test/helpers/dream-mock.js";
26
-
27
- const pass = (ok) => (ok ? "✅" : "❌");
28
-
29
- // ---------------------------------------------------------------- 轴线 1
30
-
31
- async function axis1LongSessionRetrieval() {
32
- console.log("【轴线 1】长会话检索:Recall@k 与陈旧残留率");
33
- const topics = 20;
34
- const rounds = 8;
35
- const dir = mkdtempSync(join(tmpdir(), "dsh-mneme-stress-a1-"));
36
- const store = createStore(join(dir, "memory.db"));
37
- const service = createService({ store, mirror: null, config: {} });
38
- const dream = createDreamScheduler({ onRun: () => Promise.resolve({ ok: true, skipped: true }) });
39
- const ctx = mockCtx({ onConsolidation: sessionDecisions });
40
-
41
- // 每个主题一条规范记忆(ground truth,importance 5)
42
- const gt = [];
43
- for (let t = 1; t <= topics; t++) {
44
- const title = `主题${String(t).padStart(2, "0")}`;
45
- const { memory } = service.saveWithDedupe({ type: "project", title, content: `${title} 的规范内容`, importance: 5 });
46
- gt.push({ title, id: memory.id });
47
- }
48
- // 长会话:每轮追加同主题旧变体(importance 3)并触发一次 autoDream
49
- for (let round = 1; round <= rounds; round++) {
50
- for (let t = 1; t <= topics; t++) {
51
- service.saveWithDedupe({
52
- type: "project",
53
- title: `主题${String(t).padStart(2, "0")}·变体${round}`,
54
- content: `主题${t} 第${round}轮旧变体`,
55
- importance: 3
56
- });
57
- }
58
- await dream.runDream(ctx, service, {});
59
- }
60
-
61
- let hits5 = 0;
62
- let hits10 = 0;
63
- for (const { title, id } of gt) {
64
- const k5 = service.search(title, { limit: 5 });
65
- const k10 = service.search(title, { limit: 10 });
66
- if (k5.some((m) => m.id === id)) hits5++;
67
- if (k10.some((m) => m.id === id)) hits10++;
68
- }
69
- const recall5 = hits5 / topics;
70
- const recall10 = hits10 / topics;
71
-
72
- // 陈旧残留率 = 仍活跃的旧变体 / 全部旧变体(dream 应全部清掉 → 0)
73
- const all = store.all();
74
- const variants = all.filter((m) => m.type === "project" && m.title.includes("变体"));
75
- const staleResidual = variants.filter((m) => !m.archived).length / variants.length;
76
- const runs = store.listDreamRuns().length;
77
-
78
- console.log(` 主题 ${topics} 个 × 变体 ${rounds} 轮 = ${topics * rounds} 条旧记忆,autoDream 触发 ${runs} 次`);
79
- console.log(` ${pass(recall5 >= 0.95)} Recall@5 = ${(recall5 * 100).toFixed(1)}%(规范记忆 top5 召回)`);
80
- console.log(` ${pass(recall10 >= 0.95)} Recall@10 = ${(recall10 * 100).toFixed(1)}%`);
81
- console.log(` ${pass(staleResidual === 0)} 陈旧残留率 = ${(staleResidual * 100).toFixed(1)}%(理想 0%)`);
82
- store.close();
83
- return { recall5, recall10, staleResidual, runs };
84
- }
85
-
86
- // ---------------------------------------------------------------- 轴线 2
87
-
88
- async function axis2ConflictArbitration() {
89
- console.log("【轴线 2】冲突裁决:可重放仲裁集");
90
- const sets = [
91
- { key: "项目截止日期", winner: { type: "decision", title: "项目截止日期", content: "8月20日交付", importance: 5 }, loser: { type: "decision", title: "项目截止日期(旧)", content: "8月15日交付", importance: 3 } },
92
- { key: "语言偏好", winner: { type: "preference", title: "语言偏好", content: "使用简体中文", importance: 5 }, loser: { type: "preference", title: "语言偏好(旧)", content: "使用繁体中文", importance: 2 } },
93
- { key: "存储选型", winner: { type: "decision", title: "存储选型", content: "node:sqlite(零依赖)", importance: 5 }, loser: { type: "decision", title: "存储选型(旧)", content: "better-sqlite3(需编译)", importance: 3 } },
94
- { key: "部署环境", winner: { type: "project", title: "部署环境", content: "生产环境 Node 24 + Windows Server", importance: 4 }, loser: { type: "project", title: "部署环境(旧)", content: "生产环境 Node 20 + Linux", importance: 2 } }
95
- ];
96
-
97
- const dir = mkdtempSync(join(tmpdir(), "dsh-mneme-stress-a2-"));
98
- const store = createStore(join(dir, "memory.db"));
99
- const service = createService({ store, mirror: null, config: {} });
100
- const dream = createDreamScheduler({ onRun: () => Promise.resolve({ ok: true, skipped: true }) });
101
- const ctx = mockCtx({ onConsolidation: arbitrationDecisions });
102
-
103
- // 仲裁集入库(先败者后胜者,模拟旧信息先存、新信息后到)
104
- for (const set of sets) {
105
- service.saveWithDedupe({ ...set.loser });
106
- service.saveWithDedupe({ ...set.winner });
107
- }
108
- const before = hashSnapshot(service.all().filter((m) => !m.archived && m.type !== "summary"));
109
-
110
- // 跑一次裁决 → 审计 + receipt
111
- const run1 = await dream.runDream(ctx, service, {});
112
- console.log(` 裁决运行:${pass(run1.ok)}(applied=${run1.applied},receipt=${run1.receipt.slice(0, 40)}…)`);
113
-
114
- // 正确性:胜者保留 + 败者归档 + 来源链注释
115
- let arbOk = 0;
116
- for (const set of sets) {
117
- const winner = service.list({ type: set.winner.type }).find((m) => m.title === set.winner.title);
118
- const loser = store.all().find((m) => m.title === set.loser.title);
119
- if (winner && loser && loser.archived && winner.content.includes("已否决旧信息")) arbOk++;
120
- }
121
- const arbRate = arbOk / sets.length;
122
- console.log(` ${pass(arbRate === 1)} 仲裁正确率 = ${(arbRate * 100).toFixed(0)}%(胜者保留 + 败者归档 + 来源链注释)`);
123
-
124
- // 确定性:同一输入快照 → 同一决策。重跑前先把败者"复活"为原始状态。
125
- const audit = store.getDreamRun(run1.runId);
126
- const receipt = parseReceipt(audit.receipt);
127
- console.log(` ${pass(!!receipt && receipt.status === "ok")} receipt 可解析,snapshot=${receipt.snapshotHash},输入 ${receipt.inputCount} 条`);
128
- console.log(` ${pass(audit.outcome && Object.keys(audit.outcome.byId).length === sets.length * 2)} 审计 outcome 覆盖全部 ${sets.length * 2} 个仲裁对象`);
129
-
130
- // 可重放:审计中的决策清单在同一 store 上重放 → 幂等(无副作用)
131
- const winnerBefore = store.list({ type: sets[0].winner.type }).find((m) => m.title === sets[0].winner.title).content;
132
- const replayed = applyDecisions(audit.decisions, service);
133
- const winnerAfter = store.list({ type: sets[0].winner.type }).find((m) => m.title === sets[0].winner.title).content;
134
- const idempotent = replayed.applied === 0 && winnerBefore === winnerAfter;
135
- console.log(` ${pass(idempotent)} 决策清单重放幂等(repeat 无副作用,来源链不重复追加)`);
136
- console.log(` ${pass(before.length === 64)} 快照哈希稳定(${before.length} hex 位)`);
137
-
138
- const runs = store.listDreamRuns().length;
139
- store.close();
140
- return { arbRate, runs, idempotent };
141
- }
142
-
143
- // ---------------------------------------------------------------- 轴线 3
144
-
145
- function bump(content) {
146
- const m = content.match(/count=(\d+)/);
147
- return `count=${m ? Number(m[1]) + 1 : 1}`;
148
- }
149
-
150
- async function axis3Concurrency() {
151
- console.log("【轴线 3】多 Agent 并发:丢更新 / 重复合并 / 事务恢复");
152
- const dir = mkdtempSync(join(tmpdir(), "dsh-mneme-stress-a3-"));
153
- const path = join(dir, "memory.db");
154
-
155
- // --- 重复合并:20 个 agent 并发保存同标题 → 最终只 1 条活跃
156
- const sA = createStore(path);
157
- const svA = createService({ store: sA, mirror: null, config: {} });
158
- const agents = 20;
159
- const writes = [];
160
- for (let i = 0; i < agents; i++) {
161
- writes.push(Promise.resolve().then(() => svA.saveWithDedupe({ type: "preference", title: "并发任务", content: `agent-${i}` })));
162
- }
163
- await Promise.all(writes);
164
- const dupes = svA.list({ type: "preference", limit: 100 }).filter((m) => m.title === "并发任务");
165
- const noDupes = dupes.length === 1;
166
- console.log(` ${pass(noDupes)} 重复合并:${agents} 个 agent 同标题并发保存 → 活跃 ${dupes.length} 条(期望 1)`);
167
-
168
- // --- 丢更新:CAS 原子递增(硬断言:陈旧版本必须被拒,增量不得丢失)
169
- const sB = createStore(path);
170
- const svB = createService({ store: sB, mirror: null, config: {} });
171
- svA.saveWithDedupe({ type: "history", title: "计数器", content: "count=0", importance: 3 });
172
- const counterId = svA.list({ type: "history" })[0].id;
173
- svA.update(counterId, { content: "count=0" });
174
- const baseline = svA.getById(counterId); // updated_at=T, count=0
175
- // Agent A 持最新版本 → CAS 成功(count=1)
176
- const aOk = svA.compareAndUpdate(counterId, baseline.updated_at, { content: bump(baseline.content) });
177
- // Agent B 仍持过期版本 T → CAS 必须被拒;若被接受即丢更新
178
- const bStale = svB.compareAndUpdate(counterId, baseline.updated_at, { content: bump("count=0") });
179
- const casRejected = aOk !== undefined && bStale === undefined;
180
- // B 重读最新值重试 → 两个 +1 都落地
181
- if (bStale === undefined) {
182
- const cur = svB.getById(counterId);
183
- svB.compareAndUpdate(counterId, cur.updated_at, { content: bump(cur.content) });
184
- }
185
- const casResult = svB.getById(counterId).content;
186
- const noLostUpdate = casRejected && casResult === "count=2";
187
- console.log(` ${pass(noLostUpdate)} CAS 并发递增:陈旧版本被拒=${casRejected},重读重试后 → ${casResult}(期望 count=2,硬断言)`);
188
- // 串行化修复(无 CAS 时的人工约定):写前重读最新值
189
- svA.update(counterId, { content: "count=0" });
190
- svA.update(counterId, { content: bump(svA.getById(counterId).content) });
191
- svB.update(counterId, { content: bump(svB.getById(counterId).content) });
192
- const fixedResult = svB.getById(counterId).content;
193
- const fixed = fixedResult === "count=2";
194
- console.log(` ${pass(fixed)} 串行重读修复:写前重读最新 → ${fixedResult}(期望 count=2)`);
195
-
196
- // --- 多步原子性:事务中途抛错 → 全部回滚(硬断言,无半成品)
197
- let txThrew = false;
198
- try {
199
- svB.transaction(() => {
200
- svB.saveWithDedupe({ type: "project", title: "原子A", content: "x" });
201
- svB.saveWithDedupe({ type: "project", title: "原子B", content: "y" });
202
- throw new Error("boom");
203
- });
204
- } catch { txThrew = true; }
205
- const allNow = svB.all();
206
- const atomic = txThrew
207
- && !allNow.some((m) => m.title === "原子A")
208
- && !allNow.some((m) => m.title === "原子B");
209
- console.log(` ${pass(atomic)} 多步原子性:事务中途抛错 → 原子A/原子B 全部回滚(期望均不存在,硬断言)`);
210
-
211
- // --- 事务/崩溃恢复:已提交写入在异常后 + reopen 后完整保留
212
- const svC = createService({ store: sB, mirror: null, config: {} }); // 复用同一文件连接
213
- svC.saveWithDedupe({ type: "project", title: "已提交A", content: "x" });
214
- svC.saveWithDedupe({ type: "project", title: "已提交B", content: "y" });
215
- let threw = false;
216
- try {
217
- svC.update("nonexistent-id", { content: "boom" }); // store.update 对未知 id 抛错
218
- } catch {
219
- threw = true;
220
- }
221
- sA.close();
222
- sB.close();
223
- const sR = createStore(path); // 重新打开(模拟进程重启)
224
- const recovered = sR.all();
225
- const recoveryOk = threw
226
- && recovered.some((m) => m.title === "已提交A")
227
- && recovered.some((m) => m.title === "已提交B")
228
- && recovered.some((m) => m.title === "计数器");
229
- console.log(` ${pass(recoveryOk)} 事务恢复:中途异常后已提交写入不丢,reopen 后完整可读`);
230
- console.log(` ${pass(recovered.filter((m) => m.title === "已提交A").length === 1)} 无半成品残留(已提交A 仅 1 条)`);
231
-
232
- sR.close();
233
- return { noDupes, noLostUpdate, atomic, fixed, recoveryOk };
234
- }
235
-
236
- // ---------------------------------------------------------------- 汇总
237
-
238
- console.log("══════ dsh-mneme 压测:三条轴线 ══════");
239
- console.log("");
240
- const a1 = await axis1LongSessionRetrieval();
241
- console.log("");
242
- const a2 = await axis2ConflictArbitration();
243
- console.log("");
244
- const a3 = await axis3Concurrency();
245
- console.log("");
246
- console.log("══════ 压测汇总 ══════");
247
- console.log(` 轴线1 长会话检索:Recall@5=${(a1.recall5 * 100).toFixed(1)}% Recall@10=${(a1.recall10 * 100).toFixed(1)}% 陈旧残留=${(a1.staleResidual * 100).toFixed(1)}% (${a1.runs} 次 autoDream 全部入审计)`);
248
- console.log(` 轴线2 冲突裁决:仲裁正确率=${(a2.arbRate * 100).toFixed(0)}% 重放幂等=${a2.idempotent ? "是" : "否"}`);
249
- console.log(` 轴线3 多 Agent 并发:去重=${a3.noDupes ? "✅" : "❌"} CAS无丢更新=${a3.noLostUpdate ? "✅" : "❌"} 多步原子=${a3.atomic ? "✅" : "❌"} 串行修复=${a3.fixed ? "✅" : "❌"} 崩溃恢复=${a3.recoveryOk ? "✅" : "❌"}`);
250
- // 丢更新与多步原子性都是硬断言:任一失败 → 非零退出,绝不把风险标成通过
251
- const allOk = a1.recall5 >= 0.95 && a1.staleResidual === 0 && a2.arbRate === 1 && a2.idempotent
252
- && a3.noDupes && a3.noLostUpdate && a3.atomic && a3.fixed && a3.recoveryOk;
253
- console.log(` 结论:${allOk ? "全部通过 ✅" : "存在失败项 ❌"}`);
254
- console.log("══════ 压测结束 ══════");
255
- process.exit(allOk ? 0 : 1);
1
+ // scripts/stress-dsh.js
2
+ // 压测:沿着三条轴线检验 dsh-mneme 的 autoDream 与存储在长会话、冲突、
3
+ // 并发压力下的表现。LLM 全部用确定性的 mock 决策,离线可跑、无需 API Key。
4
+ //
5
+ // 轴线 1 · 长会话检索:Recall@k(规范记忆能否被召回)与陈旧残留率
6
+ // 轴线 2 · 冲突裁决:可重放仲裁集 —— 仲裁正确率、确定性、审计/回放
7
+ // 轴线 3 · 多 Agent 并发:丢更新、重复合并、事务/崩溃恢复
8
+ //
9
+ // 运行:node scripts/stress-dsh.js
10
+ import { mkdtempSync } from "node:fs";
11
+ import { tmpdir } from "node:os";
12
+ import { join } from "node:path";
13
+ import { createStore } from "../src/store.js";
14
+ import { createService } from "../src/service.js";
15
+ import {
16
+ createDreamScheduler,
17
+ hashSnapshot,
18
+ parseReceipt
19
+ } from "../src/dream.js";
20
+ import { applyDecisions } from "../src/dream/decisions.js";
21
+ import {
22
+ sessionDecisions,
23
+ arbitrationDecisions,
24
+ mockCtx
25
+ } from "../test/helpers/dream-mock.js";
26
+
27
+ const pass = (ok) => (ok ? "✅" : "❌");
28
+
29
+ // ---------------------------------------------------------------- 轴线 1
30
+
31
+ async function axis1LongSessionRetrieval() {
32
+ console.log("【轴线 1】长会话检索:Recall@k 与陈旧残留率");
33
+ const topics = 20;
34
+ const rounds = 8;
35
+ const dir = mkdtempSync(join(tmpdir(), "dsh-mneme-stress-a1-"));
36
+ const store = createStore(join(dir, "memory.db"));
37
+ const service = createService({ store, mirror: null, config: {} });
38
+ const dream = createDreamScheduler({ onRun: () => Promise.resolve({ ok: true, skipped: true }) });
39
+ const ctx = mockCtx({ onConsolidation: sessionDecisions });
40
+
41
+ // 每个主题一条规范记忆(ground truth,importance 5)
42
+ const gt = [];
43
+ for (let t = 1; t <= topics; t++) {
44
+ const title = `主题${String(t).padStart(2, "0")}`;
45
+ const { memory } = service.saveWithDedupe({ type: "project", title, content: `${title} 的规范内容`, importance: 5 });
46
+ gt.push({ title, id: memory.id });
47
+ }
48
+ // 长会话:每轮追加同主题旧变体(importance 3)并触发一次 autoDream
49
+ for (let round = 1; round <= rounds; round++) {
50
+ for (let t = 1; t <= topics; t++) {
51
+ service.saveWithDedupe({
52
+ type: "project",
53
+ title: `主题${String(t).padStart(2, "0")}·变体${round}`,
54
+ content: `主题${t} 第${round}轮旧变体`,
55
+ importance: 3
56
+ });
57
+ }
58
+ await dream.runDream(ctx, service, {});
59
+ }
60
+
61
+ let hits5 = 0;
62
+ let hits10 = 0;
63
+ for (const { title, id } of gt) {
64
+ const k5 = service.search(title, { limit: 5 });
65
+ const k10 = service.search(title, { limit: 10 });
66
+ if (k5.some((m) => m.id === id)) hits5++;
67
+ if (k10.some((m) => m.id === id)) hits10++;
68
+ }
69
+ const recall5 = hits5 / topics;
70
+ const recall10 = hits10 / topics;
71
+
72
+ // 陈旧残留率 = 仍活跃的旧变体 / 全部旧变体(dream 应全部清掉 → 0)
73
+ const all = store.all();
74
+ const variants = all.filter((m) => m.type === "project" && m.title.includes("变体"));
75
+ const staleResidual = variants.filter((m) => !m.archived).length / variants.length;
76
+ const runs = store.listDreamRuns().length;
77
+
78
+ console.log(` 主题 ${topics} 个 × 变体 ${rounds} 轮 = ${topics * rounds} 条旧记忆,autoDream 触发 ${runs} 次`);
79
+ console.log(` ${pass(recall5 >= 0.95)} Recall@5 = ${(recall5 * 100).toFixed(1)}%(规范记忆 top5 召回)`);
80
+ console.log(` ${pass(recall10 >= 0.95)} Recall@10 = ${(recall10 * 100).toFixed(1)}%`);
81
+ console.log(` ${pass(staleResidual === 0)} 陈旧残留率 = ${(staleResidual * 100).toFixed(1)}%(理想 0%)`);
82
+ store.close();
83
+ return { recall5, recall10, staleResidual, runs };
84
+ }
85
+
86
+ // ---------------------------------------------------------------- 轴线 2
87
+
88
+ async function axis2ConflictArbitration() {
89
+ console.log("【轴线 2】冲突裁决:可重放仲裁集");
90
+ const sets = [
91
+ { key: "项目截止日期", winner: { type: "decision", title: "项目截止日期", content: "8月20日交付", importance: 5 }, loser: { type: "decision", title: "项目截止日期(旧)", content: "8月15日交付", importance: 3 } },
92
+ { key: "语言偏好", winner: { type: "preference", title: "语言偏好", content: "使用简体中文", importance: 5 }, loser: { type: "preference", title: "语言偏好(旧)", content: "使用繁体中文", importance: 2 } },
93
+ { key: "存储选型", winner: { type: "decision", title: "存储选型", content: "node:sqlite(零依赖)", importance: 5 }, loser: { type: "decision", title: "存储选型(旧)", content: "better-sqlite3(需编译)", importance: 3 } },
94
+ { key: "部署环境", winner: { type: "project", title: "部署环境", content: "生产环境 Node 24 + Windows Server", importance: 4 }, loser: { type: "project", title: "部署环境(旧)", content: "生产环境 Node 20 + Linux", importance: 2 } }
95
+ ];
96
+
97
+ const dir = mkdtempSync(join(tmpdir(), "dsh-mneme-stress-a2-"));
98
+ const store = createStore(join(dir, "memory.db"));
99
+ const service = createService({ store, mirror: null, config: {} });
100
+ const dream = createDreamScheduler({ onRun: () => Promise.resolve({ ok: true, skipped: true }) });
101
+ const ctx = mockCtx({ onConsolidation: arbitrationDecisions });
102
+
103
+ // 仲裁集入库(先败者后胜者,模拟旧信息先存、新信息后到)
104
+ for (const set of sets) {
105
+ service.saveWithDedupe({ ...set.loser });
106
+ service.saveWithDedupe({ ...set.winner });
107
+ }
108
+ const before = hashSnapshot(service.all().filter((m) => !m.archived && m.type !== "summary"));
109
+
110
+ // 跑一次裁决 → 审计 + receipt
111
+ const run1 = await dream.runDream(ctx, service, {});
112
+ console.log(` 裁决运行:${pass(run1.ok)}(applied=${run1.applied},receipt=${run1.receipt.slice(0, 40)}…)`);
113
+
114
+ // 正确性:胜者保留 + 败者归档 + 来源链注释
115
+ let arbOk = 0;
116
+ for (const set of sets) {
117
+ const winner = service.list({ type: set.winner.type }).find((m) => m.title === set.winner.title);
118
+ const loser = store.all().find((m) => m.title === set.loser.title);
119
+ if (winner && loser && loser.archived && winner.content.includes("已否决旧信息")) arbOk++;
120
+ }
121
+ const arbRate = arbOk / sets.length;
122
+ console.log(` ${pass(arbRate === 1)} 仲裁正确率 = ${(arbRate * 100).toFixed(0)}%(胜者保留 + 败者归档 + 来源链注释)`);
123
+
124
+ // 确定性:同一输入快照 → 同一决策。重跑前先把败者"复活"为原始状态。
125
+ const audit = store.getDreamRun(run1.runId);
126
+ const receipt = parseReceipt(audit.receipt);
127
+ console.log(` ${pass(!!receipt && receipt.status === "ok")} receipt 可解析,snapshot=${receipt.snapshotHash},输入 ${receipt.inputCount} 条`);
128
+ console.log(` ${pass(audit.outcome && Object.keys(audit.outcome.byId).length === sets.length * 2)} 审计 outcome 覆盖全部 ${sets.length * 2} 个仲裁对象`);
129
+
130
+ // 可重放:审计中的决策清单在同一 store 上重放 → 幂等(无副作用)
131
+ const winnerBefore = store.list({ type: sets[0].winner.type }).find((m) => m.title === sets[0].winner.title).content;
132
+ const replayed = applyDecisions(audit.decisions, service);
133
+ const winnerAfter = store.list({ type: sets[0].winner.type }).find((m) => m.title === sets[0].winner.title).content;
134
+ const idempotent = replayed.applied === 0 && winnerBefore === winnerAfter;
135
+ console.log(` ${pass(idempotent)} 决策清单重放幂等(repeat 无副作用,来源链不重复追加)`);
136
+ console.log(` ${pass(before.length === 64)} 快照哈希稳定(${before.length} hex 位)`);
137
+
138
+ const runs = store.listDreamRuns().length;
139
+ store.close();
140
+ return { arbRate, runs, idempotent };
141
+ }
142
+
143
+ // ---------------------------------------------------------------- 轴线 3
144
+
145
+ function bump(content) {
146
+ const m = content.match(/count=(\d+)/);
147
+ return `count=${m ? Number(m[1]) + 1 : 1}`;
148
+ }
149
+
150
+ async function axis3Concurrency() {
151
+ console.log("【轴线 3】多 Agent 并发:丢更新 / 重复合并 / 事务恢复");
152
+ const dir = mkdtempSync(join(tmpdir(), "dsh-mneme-stress-a3-"));
153
+ const path = join(dir, "memory.db");
154
+
155
+ // --- 重复合并:20 个 agent 并发保存同标题 → 最终只 1 条活跃
156
+ const sA = createStore(path);
157
+ const svA = createService({ store: sA, mirror: null, config: {} });
158
+ const agents = 20;
159
+ const writes = [];
160
+ for (let i = 0; i < agents; i++) {
161
+ writes.push(Promise.resolve().then(() => svA.saveWithDedupe({ type: "preference", title: "并发任务", content: `agent-${i}` })));
162
+ }
163
+ await Promise.all(writes);
164
+ const dupes = svA.list({ type: "preference", limit: 100 }).filter((m) => m.title === "并发任务");
165
+ const noDupes = dupes.length === 1;
166
+ console.log(` ${pass(noDupes)} 重复合并:${agents} 个 agent 同标题并发保存 → 活跃 ${dupes.length} 条(期望 1)`);
167
+
168
+ // --- 丢更新:CAS 原子递增(硬断言:陈旧版本必须被拒,增量不得丢失)
169
+ const sB = createStore(path);
170
+ const svB = createService({ store: sB, mirror: null, config: {} });
171
+ svA.saveWithDedupe({ type: "history", title: "计数器", content: "count=0", importance: 3 });
172
+ const counterId = svA.list({ type: "history" })[0].id;
173
+ svA.update(counterId, { content: "count=0" });
174
+ const baseline = svA.getById(counterId); // updated_at=T, count=0
175
+ // Agent A 持最新版本 → CAS 成功(count=1)
176
+ const aOk = svA.compareAndUpdate(counterId, baseline.updated_at, { content: bump(baseline.content) });
177
+ // Agent B 仍持过期版本 T → CAS 必须被拒;若被接受即丢更新
178
+ const bStale = svB.compareAndUpdate(counterId, baseline.updated_at, { content: bump("count=0") });
179
+ const casRejected = aOk !== undefined && bStale === undefined;
180
+ // B 重读最新值重试 → 两个 +1 都落地
181
+ if (bStale === undefined) {
182
+ const cur = svB.getById(counterId);
183
+ svB.compareAndUpdate(counterId, cur.updated_at, { content: bump(cur.content) });
184
+ }
185
+ const casResult = svB.getById(counterId).content;
186
+ const noLostUpdate = casRejected && casResult === "count=2";
187
+ console.log(` ${pass(noLostUpdate)} CAS 并发递增:陈旧版本被拒=${casRejected},重读重试后 → ${casResult}(期望 count=2,硬断言)`);
188
+ // 串行化修复(无 CAS 时的人工约定):写前重读最新值
189
+ svA.update(counterId, { content: "count=0" });
190
+ svA.update(counterId, { content: bump(svA.getById(counterId).content) });
191
+ svB.update(counterId, { content: bump(svB.getById(counterId).content) });
192
+ const fixedResult = svB.getById(counterId).content;
193
+ const fixed = fixedResult === "count=2";
194
+ console.log(` ${pass(fixed)} 串行重读修复:写前重读最新 → ${fixedResult}(期望 count=2)`);
195
+
196
+ // --- 多步原子性:事务中途抛错 → 全部回滚(硬断言,无半成品)
197
+ let txThrew = false;
198
+ try {
199
+ svB.transaction(() => {
200
+ svB.saveWithDedupe({ type: "project", title: "原子A", content: "x" });
201
+ svB.saveWithDedupe({ type: "project", title: "原子B", content: "y" });
202
+ throw new Error("boom");
203
+ });
204
+ } catch { txThrew = true; }
205
+ const allNow = svB.all();
206
+ const atomic = txThrew
207
+ && !allNow.some((m) => m.title === "原子A")
208
+ && !allNow.some((m) => m.title === "原子B");
209
+ console.log(` ${pass(atomic)} 多步原子性:事务中途抛错 → 原子A/原子B 全部回滚(期望均不存在,硬断言)`);
210
+
211
+ // --- 事务/崩溃恢复:已提交写入在异常后 + reopen 后完整保留
212
+ const svC = createService({ store: sB, mirror: null, config: {} }); // 复用同一文件连接
213
+ svC.saveWithDedupe({ type: "project", title: "已提交A", content: "x" });
214
+ svC.saveWithDedupe({ type: "project", title: "已提交B", content: "y" });
215
+ let threw = false;
216
+ try {
217
+ svC.update("nonexistent-id", { content: "boom" }); // store.update 对未知 id 抛错
218
+ } catch {
219
+ threw = true;
220
+ }
221
+ sA.close();
222
+ sB.close();
223
+ const sR = createStore(path); // 重新打开(模拟进程重启)
224
+ const recovered = sR.all();
225
+ const recoveryOk = threw
226
+ && recovered.some((m) => m.title === "已提交A")
227
+ && recovered.some((m) => m.title === "已提交B")
228
+ && recovered.some((m) => m.title === "计数器");
229
+ console.log(` ${pass(recoveryOk)} 事务恢复:中途异常后已提交写入不丢,reopen 后完整可读`);
230
+ console.log(` ${pass(recovered.filter((m) => m.title === "已提交A").length === 1)} 无半成品残留(已提交A 仅 1 条)`);
231
+
232
+ sR.close();
233
+ return { noDupes, noLostUpdate, atomic, fixed, recoveryOk };
234
+ }
235
+
236
+ // ---------------------------------------------------------------- 汇总
237
+
238
+ console.log("══════ dsh-mneme 压测:三条轴线 ══════");
239
+ console.log("");
240
+ const a1 = await axis1LongSessionRetrieval();
241
+ console.log("");
242
+ const a2 = await axis2ConflictArbitration();
243
+ console.log("");
244
+ const a3 = await axis3Concurrency();
245
+ console.log("");
246
+ console.log("══════ 压测汇总 ══════");
247
+ console.log(` 轴线1 长会话检索:Recall@5=${(a1.recall5 * 100).toFixed(1)}% Recall@10=${(a1.recall10 * 100).toFixed(1)}% 陈旧残留=${(a1.staleResidual * 100).toFixed(1)}% (${a1.runs} 次 autoDream 全部入审计)`);
248
+ console.log(` 轴线2 冲突裁决:仲裁正确率=${(a2.arbRate * 100).toFixed(0)}% 重放幂等=${a2.idempotent ? "是" : "否"}`);
249
+ console.log(` 轴线3 多 Agent 并发:去重=${a3.noDupes ? "✅" : "❌"} CAS无丢更新=${a3.noLostUpdate ? "✅" : "❌"} 多步原子=${a3.atomic ? "✅" : "❌"} 串行修复=${a3.fixed ? "✅" : "❌"} 崩溃恢复=${a3.recoveryOk ? "✅" : "❌"}`);
250
+ // 丢更新与多步原子性都是硬断言:任一失败 → 非零退出,绝不把风险标成通过
251
+ const allOk = a1.recall5 >= 0.95 && a1.staleResidual === 0 && a2.arbRate === 1 && a2.idempotent
252
+ && a3.noDupes && a3.noLostUpdate && a3.atomic && a3.fixed && a3.recoveryOk;
253
+ console.log(` 结论:${allOk ? "全部通过 ✅" : "存在失败项 ❌"}`);
254
+ console.log("══════ 压测结束 ══════");
255
+ process.exit(allOk ? 0 : 1);
@@ -1,47 +1,47 @@
1
- // Sync the src/ tree into lib/ — the distributable consumed by DSH (package
2
- // main is lib/index.js). lib/client.js (the Web panel bundle) is authored
3
- // independently under lib/ and is left untouched: the sync only copies
4
- // src -> lib, it never prunes lib-only files.
5
- //
6
- // Usage: npm run sync (also run automatically by `npm pack`/`npm publish`
7
- // via the prepack hook, so a published tarball always ships a fresh lib/).
8
- import { cpSync, existsSync, mkdirSync, readdirSync } from "node:fs";
9
- import { join, relative } from "node:path";
10
- import { fileURLToPath } from "node:url";
11
-
12
- const root = join(fileURLToPath(new URL("..", import.meta.url)));
13
- const srcDir = join(root, "src");
14
- const libDir = join(root, "lib");
15
-
16
- /** Recursively collect all files under a directory (sorted for stable output). */
17
- function walk(dir) {
18
- const out = [];
19
- for (const entry of readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
20
- const full = join(dir, entry.name);
21
- if (entry.isDirectory()) out.push(...walk(full));
22
- else if (entry.isFile()) out.push(full);
23
- }
24
- return out;
25
- }
26
-
27
- let copied = 0;
28
- mkdirSync(libDir, { recursive: true });
29
-
30
- for (const file of walk(srcDir)) {
31
- const rel = relative(srcDir, file);
32
- const dest = join(libDir, rel);
33
- mkdirSync(join(dest, ".."), { recursive: true });
34
- cpSync(file, dest);
35
- copied++;
36
- console.log(`synced ${rel}`);
37
- }
38
-
39
- // Report lib-only files (authored separately, e.g. client.js) so drift is
40
- // visible but never clobbered.
41
- for (const file of walk(libDir)) {
42
- const rel = relative(libDir, file);
43
- if (!existsSync(join(srcDir, rel))) console.log(`kept ${rel} (lib-only, not pruned)`);
44
- }
45
-
46
- console.log(`\nSynced ${copied} file(s) from src/ to lib/.`);
47
- if (!copied) process.exitCode = 1;
1
+ // Sync the src/ tree into lib/ — the distributable consumed by DSH (package
2
+ // main is lib/index.js). lib/client.js (the Web panel bundle) is authored
3
+ // independently under lib/ and is left untouched: the sync only copies
4
+ // src -> lib, it never prunes lib-only files.
5
+ //
6
+ // Usage: npm run sync (also run automatically by `npm pack`/`npm publish`
7
+ // via the prepack hook, so a published tarball always ships a fresh lib/).
8
+ import { cpSync, existsSync, mkdirSync, readdirSync } from "node:fs";
9
+ import { join, relative } from "node:path";
10
+ import { fileURLToPath } from "node:url";
11
+
12
+ const root = join(fileURLToPath(new URL("..", import.meta.url)));
13
+ const srcDir = join(root, "src");
14
+ const libDir = join(root, "lib");
15
+
16
+ /** Recursively collect all files under a directory (sorted for stable output). */
17
+ function walk(dir) {
18
+ const out = [];
19
+ for (const entry of readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
20
+ const full = join(dir, entry.name);
21
+ if (entry.isDirectory()) out.push(...walk(full));
22
+ else if (entry.isFile()) out.push(full);
23
+ }
24
+ return out;
25
+ }
26
+
27
+ let copied = 0;
28
+ mkdirSync(libDir, { recursive: true });
29
+
30
+ for (const file of walk(srcDir)) {
31
+ const rel = relative(srcDir, file);
32
+ const dest = join(libDir, rel);
33
+ mkdirSync(join(dest, ".."), { recursive: true });
34
+ cpSync(file, dest);
35
+ copied++;
36
+ console.log(`synced ${rel}`);
37
+ }
38
+
39
+ // Report lib-only files (authored separately, e.g. client.js) so drift is
40
+ // visible but never clobbered.
41
+ for (const file of walk(libDir)) {
42
+ const rel = relative(libDir, file);
43
+ if (!existsSync(join(srcDir, rel))) console.log(`kept ${rel} (lib-only, not pruned)`);
44
+ }
45
+
46
+ console.log(`\nSynced ${copied} file(s) from src/ to lib/.`);
47
+ if (!copied) process.exitCode = 1;