@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,86 +1,86 @@
1
- import test from "node:test";
2
- import assert from "node:assert/strict";
3
- import { createStore } from "../src/store.js";
4
- import { createService } from "../src/service.js";
5
- import { createDreamScheduler, validateDecisions } from "../src/dream.js";
6
- import { mockCtx } from "./helpers/dream-mock.js";
7
-
8
- // 回归(issue #104 方向 1):dreamMinExplicitCoverage 覆盖率护栏误伤「挑重点」
9
- // 型输出。提示词明文要求「无问题的条目无需输出」(lang.js 硬性规则),模型
10
- // 只显式决策少数条目是提示词要求的行为;但护栏把显式覆盖率 < 下限判成
11
- // 「截断 → 隐式 keep 洗白」整单拒绝——heptaspirit 实测官方路由 + 强模型也
12
- // 天天命中(81 轮 failed 全是 coverage,applied=0,LLM 调用本身已成功)。
13
- // 修复:coverage 不足降级为 degraded(合法子集照常应用 + 未提及条目隐式
14
- // keep),降级理由落库 outcome.degradations;护栏以状态暴露而非一票否决。
15
- // 明确异常信号(create 上限等)保持整单拒绝不变;dreamImplicitKeep=false 的
16
- // 严格模式不受影响。
17
-
18
- function snapshot(ids, type = "project") {
19
- return new Map(ids.map((id, i) => [id, { id, type, title: `t${i}`, content: `c${i}`, importance: 3, archived: false, forgotten: false }]));
20
- }
21
-
22
- // ---------------------------------------------------------- validateDecisions
23
-
24
- test("#104-1: coverage shortfall degrades — ok:true + reason surfaced, implicit keeps fill", () => {
25
- const snap = snapshot(["a", "b", "c", "d"]);
26
- const decisions = [{ action: "update", ids: ["a"], title: "t-new", content: "c-new" }];
27
- const { ok, errors, coverageShortfall } = validateDecisions(decisions, snap, {
28
- dreamImplicitKeep: true,
29
- dreamMinExplicitCoverage: 0.5,
30
- skipInvalid: true
31
- });
32
- assert.equal(ok, true, "valid subset is applied instead of whole-order rejection");
33
- assert.deepEqual(errors, [], "coverage shortfall is not a per-decision error");
34
- assert.match(String(coverageShortfall), /coverage/, "degradation reason surfaced for audit");
35
- assert.equal(decisions.length, 4, "unclaimed ids filled with implicit keeps");
36
- });
37
-
38
- test("#104-1: sufficient coverage carries no shortfall marker", () => {
39
- const snap = snapshot(["a", "b"]);
40
- const decisions = [{ action: "archive", ids: ["a"], reason: "stale" }, { action: "keep", ids: ["b"] }];
41
- const { ok, coverageShortfall } = validateDecisions(decisions, snap, {
42
- dreamImplicitKeep: true,
43
- dreamMinExplicitCoverage: 0.5
44
- });
45
- assert.equal(ok, true);
46
- assert.equal(coverageShortfall ?? null, null);
47
- });
48
-
49
- test("#104-1: strict mode (implicitKeep=false) unchanged — missing ids still reject", () => {
50
- const snap = snapshot(["a", "b"]);
51
- const decisions = [{ action: "keep", ids: ["a"] }];
52
- const { ok } = validateDecisions(decisions, snap, { dreamImplicitKeep: false });
53
- assert.equal(ok, false, "strict mode keeps whole-order rejection");
54
- });
55
-
56
- // ---------------------------------------------------------- runDream 端到端
57
-
58
- test("#104-1: runDream records degraded (not failed) with the coverage reason in the run row", async () => {
59
- const store = createStore(":memory:");
60
- const service = createService({ store, mirror: null, config: {} });
61
- for (let i = 0; i < 20; i++) {
62
- service.saveWithDedupe({ type: "project", title: `主题${i}`, content: `内容${i}`, importance: 3 });
63
- }
64
- // 只显式决策 1/20 = 5%(< 默认下限 50%)——提示词要求的「挑重点」形态
65
- const ctx = mockCtx({
66
- onConsolidation: (listText) => {
67
- const ids = [...listText.matchAll(/id=([^\s|]+)\s*\|\s*type=(\w+)/g)].map((m) => m[1]);
68
- return JSON.stringify([{ action: "archive", ids: [ids[0]], reason: "stale variant" }]);
69
- }
70
- });
71
- const dream = createDreamScheduler({ thresholdCount: 1, thresholdChars: 0, delayMs: 0 });
72
- const result = await dream.runDream(ctx, service, {
73
- dreamProvider: "deepseek",
74
- dreamModel: "deepseek-chat",
75
- dreamMinExplicitCoverage: 0.5
76
- });
77
- assert.equal(result.status, "degraded", "coverage shortfall degrades the run, not rejects it");
78
- assert.equal(result.ok, true, "valid subset absorbed — scheduler baseline advances");
79
- assert.ok(result.applied >= 1, "the explicit decision was applied");
80
-
81
- const run = store.listDreamRuns()[0];
82
- assert.equal(run.status, "degraded");
83
- const degradations = run.outcome?.degradations ?? [];
84
- assert.ok(degradations.some((s) => String(s).includes("coverage")), "coverage reason persisted in outcome.degradations");
85
- store.close();
86
- });
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import { createStore } from "../src/store.js";
4
+ import { createService } from "../src/service.js";
5
+ import { createDreamScheduler, validateDecisions } from "../src/dream.js";
6
+ import { mockCtx } from "./helpers/dream-mock.js";
7
+
8
+ // 回归(issue #104 方向 1):dreamMinExplicitCoverage 覆盖率护栏误伤「挑重点」
9
+ // 型输出。提示词明文要求「无问题的条目无需输出」(lang.js 硬性规则),模型
10
+ // 只显式决策少数条目是提示词要求的行为;但护栏把显式覆盖率 < 下限判成
11
+ // 「截断 → 隐式 keep 洗白」整单拒绝——heptaspirit 实测官方路由 + 强模型也
12
+ // 天天命中(81 轮 failed 全是 coverage,applied=0,LLM 调用本身已成功)。
13
+ // 修复:coverage 不足降级为 degraded(合法子集照常应用 + 未提及条目隐式
14
+ // keep),降级理由落库 outcome.degradations;护栏以状态暴露而非一票否决。
15
+ // 明确异常信号(create 上限等)保持整单拒绝不变;dreamImplicitKeep=false 的
16
+ // 严格模式不受影响。
17
+
18
+ function snapshot(ids, type = "project") {
19
+ return new Map(ids.map((id, i) => [id, { id, type, title: `t${i}`, content: `c${i}`, importance: 3, archived: false, forgotten: false }]));
20
+ }
21
+
22
+ // ---------------------------------------------------------- validateDecisions
23
+
24
+ test("#104-1: coverage shortfall degrades — ok:true + reason surfaced, implicit keeps fill", () => {
25
+ const snap = snapshot(["a", "b", "c", "d"]);
26
+ const decisions = [{ action: "update", ids: ["a"], title: "t-new", content: "c-new" }];
27
+ const { ok, errors, coverageShortfall } = validateDecisions(decisions, snap, {
28
+ dreamImplicitKeep: true,
29
+ dreamMinExplicitCoverage: 0.5,
30
+ skipInvalid: true
31
+ });
32
+ assert.equal(ok, true, "valid subset is applied instead of whole-order rejection");
33
+ assert.deepEqual(errors, [], "coverage shortfall is not a per-decision error");
34
+ assert.match(String(coverageShortfall), /coverage/, "degradation reason surfaced for audit");
35
+ assert.equal(decisions.length, 4, "unclaimed ids filled with implicit keeps");
36
+ });
37
+
38
+ test("#104-1: sufficient coverage carries no shortfall marker", () => {
39
+ const snap = snapshot(["a", "b"]);
40
+ const decisions = [{ action: "archive", ids: ["a"], reason: "stale" }, { action: "keep", ids: ["b"] }];
41
+ const { ok, coverageShortfall } = validateDecisions(decisions, snap, {
42
+ dreamImplicitKeep: true,
43
+ dreamMinExplicitCoverage: 0.5
44
+ });
45
+ assert.equal(ok, true);
46
+ assert.equal(coverageShortfall ?? null, null);
47
+ });
48
+
49
+ test("#104-1: strict mode (implicitKeep=false) unchanged — missing ids still reject", () => {
50
+ const snap = snapshot(["a", "b"]);
51
+ const decisions = [{ action: "keep", ids: ["a"] }];
52
+ const { ok } = validateDecisions(decisions, snap, { dreamImplicitKeep: false });
53
+ assert.equal(ok, false, "strict mode keeps whole-order rejection");
54
+ });
55
+
56
+ // ---------------------------------------------------------- runDream 端到端
57
+
58
+ test("#104-1: runDream records degraded (not failed) with the coverage reason in the run row", async () => {
59
+ const store = createStore(":memory:");
60
+ const service = createService({ store, mirror: null, config: {} });
61
+ for (let i = 0; i < 20; i++) {
62
+ service.saveWithDedupe({ type: "project", title: `主题${i}`, content: `内容${i}`, importance: 3 });
63
+ }
64
+ // 只显式决策 1/20 = 5%(< 默认下限 50%)——提示词要求的「挑重点」形态
65
+ const ctx = mockCtx({
66
+ onConsolidation: (listText) => {
67
+ const ids = [...listText.matchAll(/id=([^\s|]+)\s*\|\s*type=(\w+)/g)].map((m) => m[1]);
68
+ return JSON.stringify([{ action: "archive", ids: [ids[0]], reason: "stale variant" }]);
69
+ }
70
+ });
71
+ const dream = createDreamScheduler({ thresholdCount: 1, thresholdChars: 0, delayMs: 0 });
72
+ const result = await dream.runDream(ctx, service, {
73
+ dreamProvider: "deepseek",
74
+ dreamModel: "deepseek-chat",
75
+ dreamMinExplicitCoverage: 0.5
76
+ });
77
+ assert.equal(result.status, "degraded", "coverage shortfall degrades the run, not rejects it");
78
+ assert.equal(result.ok, true, "valid subset absorbed — scheduler baseline advances");
79
+ assert.ok(result.applied >= 1, "the explicit decision was applied");
80
+
81
+ const run = store.listDreamRuns()[0];
82
+ assert.equal(run.status, "degraded");
83
+ const degradations = run.outcome?.degradations ?? [];
84
+ assert.ok(degradations.some((s) => String(s).includes("coverage")), "coverage reason persisted in outcome.degradations");
85
+ store.close();
86
+ });
@@ -1,173 +1,173 @@
1
- import test from "node:test";
2
- import assert from "node:assert/strict";
3
- import { createDreamScheduler } from "../src/dream.js";
4
- import { createStore } from "../src/store.js";
5
- import { createService } from "../src/service.js";
6
-
7
- // Issue #292:autoDream 同会话内连续失败退避(autoDreamFailureBackoff,opt-in)。
8
- //
9
- // 这些用例锁的是「调度器节流语义」,不是实现细节——防的回归是:
10
- // ① 退避闸失效/写反 → 恒定失败的模型(#135 空体面)按 dreamMinIntervalMinutes
11
- // 的固定节奏连发刷配额(#89 只挡了间隔内重试,间隔本身不会变长);
12
- // ② 成功后连败计数不清零 → 模型恢复正常后仍被旧失败拖着重试推迟(巩固变相停摆);
13
- // ③ 30 分钟封顶失效 → 指数无限翻倍,一整天都不再巩固;
14
- // ④ 默认关路径被顺手改掉 → 未 opt-in 用户的重试间隔漂移(默认关 = 行为与
15
- // 现状逐字节一致的承诺);
16
- // ⑤ 0 基数被偷偷补了间隔 → 未配 dreamMinIntervalMinutes 的用户开退避即被限流
17
- // (文档口径:基数 0 时本键不自己产生间隔)。
18
- //
19
- // 时钟与定时器全部注入(同 test/dream-peak-hours.test.js 的房型):「失败 → 推迟
20
- // → 放行」才能被确定性覆盖,也不在 CI 上留真实等待。退避从上次开跑(lastRunAt)
21
- // 起算:失败 run 本就占用基数间隔(#89 现状,lastRunAt 在开跑时刷新),退避放大
22
- // 的是同一道闸,不新增状态面。
23
- function dreamSetup() {
24
- const store = createStore(":memory:");
25
- const service = createService({ store, mirror: null, config: {} });
26
- return { store, service };
27
- }
28
-
29
- function fakeClock(startMs) {
30
- let nowMs = startMs;
31
- const timers = [];
32
- let seq = 1;
33
- return {
34
- now: () => nowMs,
35
- setNow: (v) => { nowMs = v; },
36
- timers,
37
- setTimeoutFn: (fn, delay) => { const t = { id: seq++, at: nowMs + delay, fn }; timers.push(t); return t.id; },
38
- clearTimeoutFn: (id) => { const i = timers.findIndex((t) => t.id === id); if (i >= 0) timers.splice(i, 1); }
39
- };
40
- }
41
-
42
- const T0 = new Date(2026, 8, 27, 10, 0, 0, 0).getTime();
43
-
44
- /**
45
- * 触发一次并等 run 真正落完:断言闸门这次是放行的、恰好挂了一个 delayMs=0 的
46
- * 执行定时器,点火后用 setImmediate 冲掉 startRun 的 Promise 链(纯微任务冲刷,
47
- * 不留真实等待)。失败路径下 baseline 不刷新,同一份写入可持续触发。
48
- */
49
- async function runOnce(clock, dream, service) {
50
- assert.equal(dream.maybeSchedule(service), true, "前置:阈值已过、间隔闸放行");
51
- const ts = clock.timers.splice(0);
52
- assert.equal(ts.length, 1, "前置:恰好挂了一个执行定时器");
53
- ts[0].fn();
54
- await new Promise((r) => setImmediate(r));
55
- }
56
-
57
- test("默认关:失败后重试间隔与现状一致(基数,不翻倍)", async () => {
58
- const { store, service } = dreamSetup();
59
- const clock = fakeClock(T0);
60
- let runs = 0;
61
- const dream = createDreamScheduler({
62
- onRun: async () => { runs++; return { ok: false, error: "llm failed" }; },
63
- thresholdCount: 1, thresholdChars: 0, delayMs: 0, minIntervalMs: 100,
64
- failureBackoff: false, // 显式默认值:锁「默认关 = 行为逐字节不变」
65
- logger: { warn: () => {} },
66
- now: clock.now, setTimeoutFn: clock.setTimeoutFn, clearTimeoutFn: clock.clearTimeoutFn
67
- });
68
- service.saveWithDedupe({ type: "project", title: "a", content: "x" });
69
- await runOnce(clock, dream, service); // 失败一次:失败 run 占用基数间隔(#89 现状)
70
- assert.equal(runs, 1);
71
- clock.setNow(T0 + 50);
72
- assert.equal(dream.maybeSchedule(service), false, "基数间隔内照旧跳过");
73
- clock.setNow(T0 + 100);
74
- assert.equal(dream.maybeSchedule(service), true, "关键:基数间隔一到即放行——不翻倍");
75
- store.close();
76
- });
77
-
78
- test("开启:连续失败 2 次 → 第 3 次触发被指数推迟", async () => {
79
- const { store, service } = dreamSetup();
80
- const clock = fakeClock(T0);
81
- let runs = 0;
82
- const dream = createDreamScheduler({
83
- onRun: async () => { runs++; return { ok: false, error: "empty body" }; },
84
- thresholdCount: 1, thresholdChars: 0, delayMs: 0, minIntervalMs: 100,
85
- failureBackoff: true,
86
- logger: { warn: () => {} },
87
- now: clock.now, setTimeoutFn: clock.setTimeoutFn, clearTimeoutFn: clock.clearTimeoutFn
88
- });
89
- service.saveWithDedupe({ type: "project", title: "a", content: "x" });
90
- await runOnce(clock, dream, service); // 败 1:effective = 100 × 2^1 = 200
91
- assert.equal(runs, 1);
92
- clock.setNow(T0 + 100);
93
- assert.equal(dream.maybeSchedule(service), false, "关键:基数到点不放行(现状会在 +100 放行)");
94
- clock.setNow(T0 + 200);
95
- await runOnce(clock, dream, service); // 败 2:effective = 100 × 2^2 = 400
96
- assert.equal(runs, 2);
97
- clock.setNow(T0 + 200 + 300);
98
- assert.equal(dream.maybeSchedule(service), false, "关键:2 次连败后 400ms 内不放行");
99
- clock.setNow(T0 + 200 + 400);
100
- assert.equal(dream.maybeSchedule(service), true, "自上次开跑起满 400ms 才放行第 3 次");
101
- store.close();
102
- });
103
-
104
- test("成功一次后计数清零、间隔恢复基数", async () => {
105
- const { store, service } = dreamSetup();
106
- const clock = fakeClock(T0);
107
- let failNext = true;
108
- const dream = createDreamScheduler({
109
- onRun: async () => ({ ok: !failNext }),
110
- thresholdCount: 1, thresholdChars: 0, delayMs: 0, minIntervalMs: 100,
111
- failureBackoff: true,
112
- logger: { warn: () => {} },
113
- now: clock.now, setTimeoutFn: clock.setTimeoutFn, clearTimeoutFn: clock.clearTimeoutFn
114
- });
115
- service.saveWithDedupe({ type: "project", title: "a", content: "x" });
116
- await runOnce(clock, dream, service); // 败 1:effective = 200
117
- clock.setNow(T0 + 100);
118
- assert.equal(dream.maybeSchedule(service), false, "前置:退避确实在挡(基数到点不放行)");
119
- clock.setNow(T0 + 200);
120
- failNext = false;
121
- await runOnce(clock, dream, service); // 成功:连败清零、baseline 刷新为当前库量
122
- service.saveWithDedupe({ type: "project", title: "b", content: "y" }); // 补过刷新后的阈值
123
- clock.setNow(T0 + 300); // 距上次开跑 +100 = 基数
124
- assert.equal(dream.maybeSchedule(service), true, "关键:成功清零后基数即放行(未清零要等 +400)");
125
- store.close();
126
- });
127
-
128
- test("cap:连败 10 次 → 推迟量封顶 30 分钟(未封顶需等约 34 小时)", async () => {
129
- const { store, service } = dreamSetup();
130
- const clock = fakeClock(T0);
131
- const BASE = 2 * 60000; // 2 分钟基数:2^10 × 基数 ≈ 34h,30 分钟封顶必被触发
132
- let runs = 0;
133
- const dream = createDreamScheduler({
134
- onRun: async () => { runs++; return { ok: false }; },
135
- thresholdCount: 1, thresholdChars: 0, delayMs: 0, minIntervalMs: BASE,
136
- failureBackoff: true,
137
- logger: { warn: () => {} },
138
- now: clock.now, setTimeoutFn: clock.setTimeoutFn, clearTimeoutFn: clock.clearTimeoutFn
139
- });
140
- service.saveWithDedupe({ type: "project", title: "a", content: "x" });
141
- let lastFailAt = T0;
142
- for (let i = 1; i <= 10; i++) {
143
- if (i > 1) {
144
- const wait = Math.min(BASE * 2 ** (i - 1), 30 * 60000); // 与实现同一口径的期望间隔
145
- clock.setNow(lastFailAt + wait);
146
- }
147
- await runOnce(clock, dream, service);
148
- lastFailAt = clock.now();
149
- }
150
- assert.equal(runs, 10);
151
- clock.setNow(lastFailAt + 30 * 60000 - 1);
152
- assert.equal(dream.maybeSchedule(service), false, "关键:封顶后 30 分钟内仍不放行");
153
- clock.setNow(lastFailAt + 30 * 60000);
154
- assert.equal(dream.maybeSchedule(service), true, "封顶生效:恰好 30 分钟放行,不再随失败数翻倍");
155
- store.close();
156
- });
157
-
158
- test("基数为 0 时退避不自己产生间隔(需先配 dreamMinIntervalMinutes)", async () => {
159
- const { store, service } = dreamSetup();
160
- const clock = fakeClock(T0);
161
- const dream = createDreamScheduler({
162
- onRun: async () => ({ ok: false }),
163
- thresholdCount: 1, thresholdChars: 0, delayMs: 0, minIntervalMs: 0,
164
- failureBackoff: true,
165
- logger: { warn: () => {} },
166
- now: clock.now, setTimeoutFn: clock.setTimeoutFn, clearTimeoutFn: clock.clearTimeoutFn
167
- });
168
- service.saveWithDedupe({ type: "project", title: "a", content: "x" });
169
- await runOnce(clock, dream, service); // 失败一次
170
- clock.setNow(T0);
171
- assert.equal(dream.maybeSchedule(service), true, "关键:0 基数无闸可翻倍,开退避也不限流");
172
- store.close();
173
- });
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import { createDreamScheduler } from "../src/dream.js";
4
+ import { createStore } from "../src/store.js";
5
+ import { createService } from "../src/service.js";
6
+
7
+ // Issue #292:autoDream 同会话内连续失败退避(autoDreamFailureBackoff,opt-in)。
8
+ //
9
+ // 这些用例锁的是「调度器节流语义」,不是实现细节——防的回归是:
10
+ // ① 退避闸失效/写反 → 恒定失败的模型(#135 空体面)按 dreamMinIntervalMinutes
11
+ // 的固定节奏连发刷配额(#89 只挡了间隔内重试,间隔本身不会变长);
12
+ // ② 成功后连败计数不清零 → 模型恢复正常后仍被旧失败拖着重试推迟(巩固变相停摆);
13
+ // ③ 30 分钟封顶失效 → 指数无限翻倍,一整天都不再巩固;
14
+ // ④ 默认关路径被顺手改掉 → 未 opt-in 用户的重试间隔漂移(默认关 = 行为与
15
+ // 现状逐字节一致的承诺);
16
+ // ⑤ 0 基数被偷偷补了间隔 → 未配 dreamMinIntervalMinutes 的用户开退避即被限流
17
+ // (文档口径:基数 0 时本键不自己产生间隔)。
18
+ //
19
+ // 时钟与定时器全部注入(同 test/dream-peak-hours.test.js 的房型):「失败 → 推迟
20
+ // → 放行」才能被确定性覆盖,也不在 CI 上留真实等待。退避从上次开跑(lastRunAt)
21
+ // 起算:失败 run 本就占用基数间隔(#89 现状,lastRunAt 在开跑时刷新),退避放大
22
+ // 的是同一道闸,不新增状态面。
23
+ function dreamSetup() {
24
+ const store = createStore(":memory:");
25
+ const service = createService({ store, mirror: null, config: {} });
26
+ return { store, service };
27
+ }
28
+
29
+ function fakeClock(startMs) {
30
+ let nowMs = startMs;
31
+ const timers = [];
32
+ let seq = 1;
33
+ return {
34
+ now: () => nowMs,
35
+ setNow: (v) => { nowMs = v; },
36
+ timers,
37
+ setTimeoutFn: (fn, delay) => { const t = { id: seq++, at: nowMs + delay, fn }; timers.push(t); return t.id; },
38
+ clearTimeoutFn: (id) => { const i = timers.findIndex((t) => t.id === id); if (i >= 0) timers.splice(i, 1); }
39
+ };
40
+ }
41
+
42
+ const T0 = new Date(2026, 8, 27, 10, 0, 0, 0).getTime();
43
+
44
+ /**
45
+ * 触发一次并等 run 真正落完:断言闸门这次是放行的、恰好挂了一个 delayMs=0 的
46
+ * 执行定时器,点火后用 setImmediate 冲掉 startRun 的 Promise 链(纯微任务冲刷,
47
+ * 不留真实等待)。失败路径下 baseline 不刷新,同一份写入可持续触发。
48
+ */
49
+ async function runOnce(clock, dream, service) {
50
+ assert.equal(dream.maybeSchedule(service), true, "前置:阈值已过、间隔闸放行");
51
+ const ts = clock.timers.splice(0);
52
+ assert.equal(ts.length, 1, "前置:恰好挂了一个执行定时器");
53
+ ts[0].fn();
54
+ await new Promise((r) => setImmediate(r));
55
+ }
56
+
57
+ test("默认关:失败后重试间隔与现状一致(基数,不翻倍)", async () => {
58
+ const { store, service } = dreamSetup();
59
+ const clock = fakeClock(T0);
60
+ let runs = 0;
61
+ const dream = createDreamScheduler({
62
+ onRun: async () => { runs++; return { ok: false, error: "llm failed" }; },
63
+ thresholdCount: 1, thresholdChars: 0, delayMs: 0, minIntervalMs: 100,
64
+ failureBackoff: false, // 显式默认值:锁「默认关 = 行为逐字节不变」
65
+ logger: { warn: () => {} },
66
+ now: clock.now, setTimeoutFn: clock.setTimeoutFn, clearTimeoutFn: clock.clearTimeoutFn
67
+ });
68
+ service.saveWithDedupe({ type: "project", title: "a", content: "x" });
69
+ await runOnce(clock, dream, service); // 失败一次:失败 run 占用基数间隔(#89 现状)
70
+ assert.equal(runs, 1);
71
+ clock.setNow(T0 + 50);
72
+ assert.equal(dream.maybeSchedule(service), false, "基数间隔内照旧跳过");
73
+ clock.setNow(T0 + 100);
74
+ assert.equal(dream.maybeSchedule(service), true, "关键:基数间隔一到即放行——不翻倍");
75
+ store.close();
76
+ });
77
+
78
+ test("开启:连续失败 2 次 → 第 3 次触发被指数推迟", async () => {
79
+ const { store, service } = dreamSetup();
80
+ const clock = fakeClock(T0);
81
+ let runs = 0;
82
+ const dream = createDreamScheduler({
83
+ onRun: async () => { runs++; return { ok: false, error: "empty body" }; },
84
+ thresholdCount: 1, thresholdChars: 0, delayMs: 0, minIntervalMs: 100,
85
+ failureBackoff: true,
86
+ logger: { warn: () => {} },
87
+ now: clock.now, setTimeoutFn: clock.setTimeoutFn, clearTimeoutFn: clock.clearTimeoutFn
88
+ });
89
+ service.saveWithDedupe({ type: "project", title: "a", content: "x" });
90
+ await runOnce(clock, dream, service); // 败 1:effective = 100 × 2^1 = 200
91
+ assert.equal(runs, 1);
92
+ clock.setNow(T0 + 100);
93
+ assert.equal(dream.maybeSchedule(service), false, "关键:基数到点不放行(现状会在 +100 放行)");
94
+ clock.setNow(T0 + 200);
95
+ await runOnce(clock, dream, service); // 败 2:effective = 100 × 2^2 = 400
96
+ assert.equal(runs, 2);
97
+ clock.setNow(T0 + 200 + 300);
98
+ assert.equal(dream.maybeSchedule(service), false, "关键:2 次连败后 400ms 内不放行");
99
+ clock.setNow(T0 + 200 + 400);
100
+ assert.equal(dream.maybeSchedule(service), true, "自上次开跑起满 400ms 才放行第 3 次");
101
+ store.close();
102
+ });
103
+
104
+ test("成功一次后计数清零、间隔恢复基数", async () => {
105
+ const { store, service } = dreamSetup();
106
+ const clock = fakeClock(T0);
107
+ let failNext = true;
108
+ const dream = createDreamScheduler({
109
+ onRun: async () => ({ ok: !failNext }),
110
+ thresholdCount: 1, thresholdChars: 0, delayMs: 0, minIntervalMs: 100,
111
+ failureBackoff: true,
112
+ logger: { warn: () => {} },
113
+ now: clock.now, setTimeoutFn: clock.setTimeoutFn, clearTimeoutFn: clock.clearTimeoutFn
114
+ });
115
+ service.saveWithDedupe({ type: "project", title: "a", content: "x" });
116
+ await runOnce(clock, dream, service); // 败 1:effective = 200
117
+ clock.setNow(T0 + 100);
118
+ assert.equal(dream.maybeSchedule(service), false, "前置:退避确实在挡(基数到点不放行)");
119
+ clock.setNow(T0 + 200);
120
+ failNext = false;
121
+ await runOnce(clock, dream, service); // 成功:连败清零、baseline 刷新为当前库量
122
+ service.saveWithDedupe({ type: "project", title: "b", content: "y" }); // 补过刷新后的阈值
123
+ clock.setNow(T0 + 300); // 距上次开跑 +100 = 基数
124
+ assert.equal(dream.maybeSchedule(service), true, "关键:成功清零后基数即放行(未清零要等 +400)");
125
+ store.close();
126
+ });
127
+
128
+ test("cap:连败 10 次 → 推迟量封顶 30 分钟(未封顶需等约 34 小时)", async () => {
129
+ const { store, service } = dreamSetup();
130
+ const clock = fakeClock(T0);
131
+ const BASE = 2 * 60000; // 2 分钟基数:2^10 × 基数 ≈ 34h,30 分钟封顶必被触发
132
+ let runs = 0;
133
+ const dream = createDreamScheduler({
134
+ onRun: async () => { runs++; return { ok: false }; },
135
+ thresholdCount: 1, thresholdChars: 0, delayMs: 0, minIntervalMs: BASE,
136
+ failureBackoff: true,
137
+ logger: { warn: () => {} },
138
+ now: clock.now, setTimeoutFn: clock.setTimeoutFn, clearTimeoutFn: clock.clearTimeoutFn
139
+ });
140
+ service.saveWithDedupe({ type: "project", title: "a", content: "x" });
141
+ let lastFailAt = T0;
142
+ for (let i = 1; i <= 10; i++) {
143
+ if (i > 1) {
144
+ const wait = Math.min(BASE * 2 ** (i - 1), 30 * 60000); // 与实现同一口径的期望间隔
145
+ clock.setNow(lastFailAt + wait);
146
+ }
147
+ await runOnce(clock, dream, service);
148
+ lastFailAt = clock.now();
149
+ }
150
+ assert.equal(runs, 10);
151
+ clock.setNow(lastFailAt + 30 * 60000 - 1);
152
+ assert.equal(dream.maybeSchedule(service), false, "关键:封顶后 30 分钟内仍不放行");
153
+ clock.setNow(lastFailAt + 30 * 60000);
154
+ assert.equal(dream.maybeSchedule(service), true, "封顶生效:恰好 30 分钟放行,不再随失败数翻倍");
155
+ store.close();
156
+ });
157
+
158
+ test("基数为 0 时退避不自己产生间隔(需先配 dreamMinIntervalMinutes)", async () => {
159
+ const { store, service } = dreamSetup();
160
+ const clock = fakeClock(T0);
161
+ const dream = createDreamScheduler({
162
+ onRun: async () => ({ ok: false }),
163
+ thresholdCount: 1, thresholdChars: 0, delayMs: 0, minIntervalMs: 0,
164
+ failureBackoff: true,
165
+ logger: { warn: () => {} },
166
+ now: clock.now, setTimeoutFn: clock.setTimeoutFn, clearTimeoutFn: clock.clearTimeoutFn
167
+ });
168
+ service.saveWithDedupe({ type: "project", title: "a", content: "x" });
169
+ await runOnce(clock, dream, service); // 失败一次
170
+ clock.setNow(T0);
171
+ assert.equal(dream.maybeSchedule(service), true, "关键:0 基数无闸可翻倍,开退避也不限流");
172
+ store.close();
173
+ });