@modusensus/dsh-mneme 0.8.14 → 0.8.16

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 (279) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +660 -654
  3. package/assets/icon.svg +3 -3
  4. package/bin/cli.mjs +691 -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 +275 -0
  9. package/docs/CONTINUITY.md +124 -0
  10. package/docs/DAEMON.md +46 -0
  11. package/docs/DISTILL.md +162 -0
  12. package/docs/ENTITIES.md +245 -0
  13. package/docs/LOCAL_MODEL.md +222 -0
  14. package/docs/SEMANTIC.md +256 -0
  15. package/docs/SLEEP.md +164 -0
  16. package/docs/STORAGE.md +98 -0
  17. package/lib/api-standalone.js +656 -673
  18. package/lib/api.js +1605 -1433
  19. package/lib/bootstrap.js +211 -211
  20. package/lib/client.js +6354 -5296
  21. package/lib/commands.js +95 -95
  22. package/lib/config.js +947 -843
  23. package/lib/content-hash.js +54 -54
  24. package/lib/continuity.js +220 -220
  25. package/lib/document-index.js +94 -94
  26. package/lib/document.js +303 -303
  27. package/lib/dream/clustering.js +118 -118
  28. package/lib/dream/decisions.js +694 -674
  29. package/lib/dream/narratives.js +44 -44
  30. package/lib/dream/sleep.js +819 -819
  31. package/lib/dream.js +1503 -1501
  32. package/lib/embedding.js +177 -177
  33. package/lib/entities/extractor.js +252 -252
  34. package/lib/graph/anchoring.js +179 -179
  35. package/lib/guide.js +74 -74
  36. package/lib/heat.js +144 -144
  37. package/lib/hot-memory.js +108 -46
  38. package/lib/index.js +552 -503
  39. package/lib/inject.js +428 -450
  40. package/lib/lang.js +248 -229
  41. package/lib/local-embedder.js +358 -358
  42. package/lib/maintenance.js +162 -142
  43. package/lib/mirror.js +330 -330
  44. package/lib/organize.js +450 -450
  45. package/lib/peak-hours.js +117 -117
  46. package/lib/placement.js +13 -0
  47. package/lib/pre-inject-gate.js +340 -0
  48. package/lib/quality-filter.js +126 -126
  49. package/lib/recall-stats.js +190 -175
  50. package/lib/reclaim-http.js +150 -0
  51. package/lib/reranker.js +269 -269
  52. package/lib/runtime/adopt.js +176 -176
  53. package/lib/runtime/closure.js +172 -172
  54. package/lib/runtime/download.js +247 -247
  55. package/lib/runtime/layout.js +265 -265
  56. package/lib/runtime/loader.js +252 -252
  57. package/lib/runtime/model-fetch.js +361 -361
  58. package/lib/runtime/provision.js +237 -237
  59. package/lib/runtime/tarball.js +130 -130
  60. package/lib/runtime/verify.js +223 -204
  61. package/lib/safe-slice.js +18 -0
  62. package/lib/scope.js +146 -146
  63. package/lib/search/adaptive.js +60 -60
  64. package/lib/search/bm25.js +96 -96
  65. package/lib/semantic.js +229 -229
  66. package/lib/sensitive-scan.js +209 -209
  67. package/lib/serve.js +215 -215
  68. package/lib/service.js +2688 -2605
  69. package/lib/settings.js +528 -511
  70. package/lib/store.js +3196 -3007
  71. package/lib/summarize.js +1039 -856
  72. package/lib/tools.js +743 -737
  73. package/lib/vector-index.js +110 -110
  74. package/lib/version-check.js +122 -122
  75. package/lib/write-admission.js +402 -402
  76. package/locale/en.json +6 -6
  77. package/locale/zh.json +6 -6
  78. package/package.json +118 -118
  79. package/runtime-manifest.json +526 -526
  80. package/scripts/benchmark-embed.js +201 -201
  81. package/scripts/benchmark-recall.js +249 -249
  82. package/scripts/benchmark-rerank.js +166 -166
  83. package/scripts/build-runtime-manifest.mjs +224 -224
  84. package/scripts/changelog-prep.mjs +36 -36
  85. package/scripts/check-sync.js +42 -42
  86. package/scripts/e2e-dsh.js +220 -220
  87. package/scripts/mneme-runtime.mjs +277 -277
  88. package/scripts/stress-dsh.js +255 -255
  89. package/scripts/sync-lib.js +47 -47
  90. package/scripts/sync-test-badge.mjs +69 -69
  91. package/scripts/test-count-sync.mjs +44 -44
  92. package/src/api-standalone.js +656 -673
  93. package/src/api.js +1605 -1433
  94. package/src/bootstrap.js +211 -211
  95. package/src/commands.js +95 -95
  96. package/src/config.js +947 -843
  97. package/src/content-hash.js +54 -54
  98. package/src/continuity.js +220 -220
  99. package/src/document-index.js +94 -94
  100. package/src/document.js +303 -303
  101. package/src/dream/clustering.js +118 -118
  102. package/src/dream/decisions.js +694 -674
  103. package/src/dream/narratives.js +44 -44
  104. package/src/dream/sleep.js +819 -819
  105. package/src/dream.js +1503 -1501
  106. package/src/embedding.js +177 -177
  107. package/src/entities/extractor.js +252 -252
  108. package/src/graph/anchoring.js +179 -179
  109. package/src/guide.js +74 -74
  110. package/src/heat.js +144 -144
  111. package/src/hot-memory.js +108 -46
  112. package/src/index.js +552 -503
  113. package/src/inject.js +428 -450
  114. package/src/lang.js +248 -229
  115. package/src/local-embedder.js +358 -358
  116. package/src/maintenance.js +162 -142
  117. package/src/mirror.js +330 -330
  118. package/src/organize.js +450 -450
  119. package/src/peak-hours.js +117 -117
  120. package/src/placement.js +13 -0
  121. package/src/pre-inject-gate.js +340 -0
  122. package/src/quality-filter.js +126 -126
  123. package/src/recall-stats.js +190 -175
  124. package/src/reclaim-http.js +150 -0
  125. package/src/reranker.js +269 -269
  126. package/src/runtime/adopt.js +176 -176
  127. package/src/runtime/closure.js +172 -172
  128. package/src/runtime/download.js +247 -247
  129. package/src/runtime/layout.js +265 -265
  130. package/src/runtime/loader.js +252 -252
  131. package/src/runtime/model-fetch.js +361 -361
  132. package/src/runtime/provision.js +237 -237
  133. package/src/runtime/tarball.js +130 -130
  134. package/src/runtime/verify.js +223 -204
  135. package/src/safe-slice.js +18 -0
  136. package/src/scope.js +146 -146
  137. package/src/search/adaptive.js +60 -60
  138. package/src/search/bm25.js +96 -96
  139. package/src/semantic.js +229 -229
  140. package/src/sensitive-scan.js +209 -209
  141. package/src/serve.js +215 -215
  142. package/src/service.js +2688 -2605
  143. package/src/settings.js +528 -511
  144. package/src/store.js +3196 -3007
  145. package/src/summarize.js +1039 -856
  146. package/src/tools.js +743 -737
  147. package/src/vector-index.js +110 -110
  148. package/src/version-check.js +122 -122
  149. package/src/write-admission.js +402 -402
  150. package/test/adaptive-inject-budget.test.js +85 -85
  151. package/test/api-routes-gaps.test.js +899 -218
  152. package/test/api.test.js +1725 -1690
  153. package/test/audit.test.js +448 -448
  154. package/test/baseline-persist.test.js +248 -248
  155. package/test/benchmark.test.js +94 -94
  156. package/test/bootstrap.test.js +220 -220
  157. package/test/changelog-prep.test.js +60 -60
  158. package/test/client.test.js +1582 -1169
  159. package/test/clustering.test.js +100 -100
  160. package/test/commands.test.js +106 -106
  161. package/test/config.test.js +66 -66
  162. package/test/conflict-freeze.test.js +300 -300
  163. package/test/content-hash.test.js +204 -204
  164. package/test/continuity.test.js +333 -333
  165. package/test/contrast.test.js +314 -0
  166. package/test/document-dir.test.js +233 -233
  167. package/test/document.test.js +671 -671
  168. package/test/dream-archive-guardrail.test.js +116 -116
  169. package/test/dream-candidate-hybrid.test.js +281 -281
  170. package/test/dream-coverage-degrade.test.js +86 -86
  171. package/test/dream-failure-backoff.test.js +173 -173
  172. package/test/dream-merge-guardrail.test.js +219 -0
  173. package/test/dream-peak-hours.test.js +194 -194
  174. package/test/dream.test.js +1385 -1383
  175. package/test/embedding-ready.test.js +196 -196
  176. package/test/entities.test.js +627 -547
  177. package/test/entity-recall.test.js +179 -179
  178. package/test/epistemic.test.js +325 -325
  179. package/test/fnew-0112.test.js +311 -311
  180. package/test/fnew-03.test.js +422 -422
  181. package/test/graph-anchoring.test.js +184 -184
  182. package/test/graph-api.test.js +175 -175
  183. package/test/graph-inject-budget.test.js +103 -103
  184. package/test/graph-passive-confirm.test.js +91 -91
  185. package/test/graph-weight-evolution.test.js +104 -104
  186. package/test/heat.test.js +175 -175
  187. package/test/helpers/dream-mock.js +82 -82
  188. package/test/helpers/peer-worker.mjs +25 -25
  189. package/test/helpers/runtime-source.js +60 -60
  190. package/test/helpers/tar-builder.js +80 -80
  191. package/test/helpers/write-admission-samples.js +308 -308
  192. package/test/hot-memory.test.js +211 -145
  193. package/test/inject-content-cap.test.js +91 -91
  194. package/test/inject-first-round-bm25.test.js +89 -89
  195. package/test/inject-heat.test.js +77 -77
  196. package/test/inject-parent-gate.test.js +106 -106
  197. package/test/inject-pools.test.js +194 -194
  198. package/test/inject-recall.test.js +144 -105
  199. package/test/inject-rotation.test.js +161 -161
  200. package/test/inject.test.js +443 -420
  201. package/test/lang.test.js +87 -87
  202. package/test/lastrunat-persist.test.js +101 -101
  203. package/test/lib-smoke.test.js +96 -96
  204. package/test/llm-audit.test.js +696 -598
  205. package/test/llm-message-source.test.js +207 -207
  206. package/test/local-embedder.test.js +292 -292
  207. package/test/maintenance.test.js +501 -391
  208. package/test/mcp-stdio.test.js +385 -385
  209. package/test/mirror-dirty.test.js +424 -424
  210. package/test/mirror-edit-digest.test.js +187 -187
  211. package/test/mirror-generation.test.js +499 -499
  212. package/test/mirror-types.test.js +208 -208
  213. package/test/mirror.test.js +249 -249
  214. package/test/narrative-bars.test.js +162 -162
  215. package/test/organize.test.js +418 -418
  216. package/test/peer-blockers.test.js +193 -193
  217. package/test/placement.test.js +36 -0
  218. package/test/policy-epoch.test.js +259 -259
  219. package/test/pre-inject-gate.test.js +444 -0
  220. package/test/quality-filter.test.js +186 -186
  221. package/test/reasoning-effort.test.js +752 -752
  222. package/test/recall-anti-update.test.js +82 -82
  223. package/test/recall-evals.test.js +253 -253
  224. package/test/recall-layer.test.js +326 -326
  225. package/test/recall-stats.test.js +274 -189
  226. package/test/receipt-chain.test.js +451 -451
  227. package/test/reclaim-http.test.js +209 -0
  228. package/test/reflection.test.js +226 -226
  229. package/test/reindex-backfill.test.js +62 -62
  230. package/test/reranker-single-logit.test.js +73 -73
  231. package/test/reranker.test.js +197 -197
  232. package/test/resident-status.test.js +83 -83
  233. package/test/runtime-adopt.test.js +206 -206
  234. package/test/runtime-cli.test.js +89 -89
  235. package/test/runtime-closure.test.js +193 -193
  236. package/test/runtime-download.test.js +302 -302
  237. package/test/runtime-layout.test.js +163 -163
  238. package/test/runtime-loader.test.js +255 -255
  239. package/test/runtime-manifest.test.js +159 -159
  240. package/test/runtime-model-fetch.test.js +348 -348
  241. package/test/runtime-provision.test.js +101 -101
  242. package/test/runtime-tarball.test.js +81 -81
  243. package/test/runtime-verify.test.js +319 -279
  244. package/test/scope-candidates.test.js +239 -239
  245. package/test/scope-explicit.test.js +452 -452
  246. package/test/scope-inject-soft.test.js +106 -106
  247. package/test/scope-retrieval.test.js +197 -197
  248. package/test/scope-storage.test.js +255 -255
  249. package/test/scope-strict.test.js +367 -367
  250. package/test/search-fusion.test.js +90 -90
  251. package/test/semantic.test.js +124 -124
  252. package/test/sensitive-scan.test.js +207 -207
  253. package/test/serve-bin.test.js +121 -121
  254. package/test/serve.test.js +196 -196
  255. package/test/service-search.test.js +174 -174
  256. package/test/service.test.js +410 -405
  257. package/test/settings.test.js +269 -261
  258. package/test/skip-invalid-restore.test.js +262 -262
  259. package/test/sleep-action-set.test.js +422 -422
  260. package/test/sleep-heat.test.js +126 -126
  261. package/test/sleep-scheduler-rearm.test.js +89 -89
  262. package/test/sleep.test.js +527 -527
  263. package/test/standalone-api.test.js +751 -751
  264. package/test/store-vector-cache.test.js +98 -98
  265. package/test/store.test.js +504 -396
  266. package/test/stress.test.js +209 -209
  267. package/test/summarize-occurred-at.test.js +127 -0
  268. package/test/summarize-reasoning-effort.test.js +189 -189
  269. package/test/summarize.test.js +1639 -1465
  270. package/test/supersede-state-tracking.test.js +394 -0
  271. package/test/test-count-sync.test.js +60 -60
  272. package/test/tools-dto-schema-matrix.test.js +325 -325
  273. package/test/tools-memory-get-schema.test.js +65 -65
  274. package/test/tools.test.js +428 -374
  275. package/test/updated-at-semantics.test.js +113 -113
  276. package/test/vector-index.test.js +221 -221
  277. package/test/version-check.test.js +152 -152
  278. package/test/webServer-optional.test.js +82 -82
  279. 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
+ });