@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,194 +1,194 @@
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 { createInjector } from "../src/inject.js";
6
- import { createSettings } from "../src/settings.js";
7
- import { createTools } from "../src/tools.js";
8
- import { MEMORY_GUIDE_SECTION } from "../src/guide.js";
9
-
10
- // 回归(issue #249 第一批):注入形态的两件事——
11
- // ①能力说明(injectGuidanceEnabled):工具描述补判断指引 + order 150 一次性
12
- // 总则段(常驻段必须同会话稳定,不逐轮复读);
13
- // ②B1 pin 池(pinnedInjectBudget):约束/偏好不进相关性竞争与跨轮轮换、逐字
14
- // 保真、排在块内排序之前,且有独立小预算(不占 maxInjectedItems 名额)。
15
- // 本文件给的是裸 config,两个键缺省时都按关/零算:能力说明的解析默认值由 config.js
16
- // 的 schema 给出(#249 第二批起为开,另见 test/inject-parent-gate.test.js),pin 池
17
- // 的默认值是 0。
18
-
19
- const userMsg = (text) => ({
20
- type: "user/message",
21
- data: { source: { kind: "user" }, content: [{ type: "text", text }] }
22
- });
23
-
24
- function setup(over = {}) {
25
- const store = createStore(":memory:");
26
- // 同一份 config 同时交给 service 与 injector——生产里是同一个 cfg 对象,
27
- // 而 pin 池的预算读取发生在 service 内、能力说明的开关读取发生在 injector 内。
28
- const config = { maxInjectedItems: 3, importanceThreshold: 3, ...over };
29
- const service = createService({ store, mirror: null, config });
30
- const settings = createSettings(store.db);
31
- const contexts = [];
32
- const sections = [];
33
- const ctx = {
34
- systemPrompt: {
35
- context(def) { contexts.push(def); return () => {}; },
36
- section(def) { sections.push(def); return () => {}; }
37
- }
38
- };
39
- createInjector(ctx, service, settings, config);
40
- const text = (query = "") => contexts[0].text({
41
- agent: { session: { id: "s1", snapshotEvents: () => (query ? [userMsg(query)] : []) } }
42
- });
43
- return { store, service, contexts, sections, text };
44
- }
45
-
46
- const types = (body) => [...body.matchAll(/- \[(\w+)\]/g)].map((m) => m[1]);
47
- const leadPreference = (body) => body.match(/- \[preference\] ([^((]*)/)?.[1]?.trim();
48
-
49
- test("#249: default (pinned budget 0) keeps the legacy order and adds no annotation", () => {
50
- const { service, text } = setup({});
51
- service.saveWithDedupe({ type: "summary", title: "总览", content: "总览内容", importance: 5 });
52
- service.saveWithDedupe({ type: "preference", title: "偏好A", content: "偏好内容", importance: 5 });
53
- const body = text();
54
- // 现状档位:蒸馏摘要(0) 先于偏好(1)。pin 关闭时不得出现「偏好前置」这一改动。
55
- assert.deepEqual(types(body), ["summary", "preference"], "budget 0 → legacy priority order");
56
- assert.ok(!body.includes("未展示"), "pool off → no overflow annotation");
57
- });
58
-
59
- test("#249: pinned entries lead the block and sit outside maxInjectedItems", () => {
60
- const { service, text } = setup({ maxInjectedItems: 2, pinnedInjectBudget: 2 });
61
- service.saveWithDedupe({ type: "summary", title: "总览", content: "总览内容", importance: 5 });
62
- service.saveWithDedupe({ type: "preference", title: "偏好A", content: "偏好甲内容", importance: 5 });
63
- service.saveWithDedupe({ type: "preference", title: "偏好B", content: "偏好乙内容", importance: 5 });
64
- service.saveWithDedupe({ type: "decision", title: "决定甲", content: "决定内容", importance: 5 });
65
- const body = text();
66
- const seq = types(body);
67
- assert.deepEqual(seq.slice(0, 2), ["preference", "preference"], "pin pool leads the block");
68
- assert.deepEqual(seq.slice(2), ["summary", "decision"], "general slots still fill to maxItems");
69
- assert.equal(seq.length, 4, "pinned entries do not consume maxInjectedItems slots");
70
- });
71
-
72
- test("#249: over-budget pinned entries are annotated with the truly hidden count", () => {
73
- const { service, text } = setup({ maxInjectedItems: 1, pinnedInjectBudget: 1 });
74
- for (let i = 0; i < 3; i++) {
75
- service.saveWithDedupe({ type: "preference", title: `偏好${i}`, content: `第 ${i} 条偏好内容`, importance: 5 });
76
- }
77
- const body = text();
78
- // 3 条同类里 pref0 被 pin、pref1 进了 general 槽(真的在块内),只有 pref2 没展示。
79
- // 按 eligible - pinned 直接相减会把 pref1 也算成未展示——虚报(#266 评审实测)。
80
- assert.ok(body.includes("偏好1"), "the over-budget one that made it into a general slot is really shown");
81
- assert.ok(body.includes("另有 1 条未展示"), `annotation must carry the hidden count: ${body}`);
82
- assert.ok(!body.includes("另有 2 条"), "no double counting");
83
- });
84
-
85
- test("#249: pinned entries are exempt from cross-turn rotation", () => {
86
- const { service, text } = setup({ maxInjectedItems: 1, pinnedInjectBudget: 1, injectRotationTurns: 2 });
87
- service.saveWithDedupe({ type: "preference", title: "偏好A", content: "偏好甲内容", importance: 5 });
88
- service.saveWithDedupe({ type: "preference", title: "偏好B", content: "偏好乙内容", importance: 5 });
89
- service.saveWithDedupe({ type: "decision", title: "决定甲", content: "决定内容", importance: 5 });
90
- service.saveWithDedupe({ type: "decision", title: "决定乙", content: "另一决定", importance: 5 });
91
- const first = leadPreference(text("第一个问题"));
92
- const second = leadPreference(text("第二个问题"));
93
- assert.ok(first, "pin entry is rendered in turn 1");
94
- assert.equal(first, second, "pin stays at the block head across turns (not rotated away)");
95
- });
96
-
97
- test("#249: pinned content is verbatim below the hard ceiling", () => {
98
- const { service, text } = setup({ maxInjectedItems: 1, pinnedInjectBudget: 1, injectContentMaxChars: 60 });
99
- const long = "约束原文".repeat(60); // 240 chars, 4× the per-entry cap
100
- service.saveWithDedupe({ type: "preference", title: "长偏好", content: long, importance: 5 });
101
- const body = text();
102
- assert.ok(body.includes(long), "240-char pinned body goes in verbatim (injectContentMaxChars does not apply)");
103
- assert.ok(!body.includes("已截断"), "no truncation hint needed below the ceiling");
104
- });
105
-
106
- test("#249: pinned content still honours the hard ceiling and says so", () => {
107
- const { service, text } = setup({ maxInjectedItems: 1, pinnedInjectBudget: 1 });
108
- const huge = "超长约束".repeat(900); // 3600 chars
109
- service.saveWithDedupe({ type: "preference", title: "超长偏好", content: huge, importance: 5 });
110
- const body = text();
111
- assert.ok(!body.includes(huge), "a runaway pinned entry cannot flood the standing block");
112
- assert.ok(body.includes("已截断"), "the cut is reported, never silent");
113
- });
114
-
115
- test("#249: pinned content does not eat the general block budget", () => {
116
- // 一条 pin 就够击穿 MAX_BLOCK(PINNED_CONTENT_MAX 2000 > MAX_BLOCK 1500):pin
117
- // 若照旧扣共享预算,budget 变负后同一轮的所有普通候选都会被压成标题行。
118
- const { service, text } = setup({ maxInjectedItems: 2, pinnedInjectBudget: 1 });
119
- const longPinned = "约束原文".repeat(470); // 1880 字符,仍在 2000 硬顶内(不带截断)
120
- service.saveWithDedupe({ type: "preference", title: "长约束", content: longPinned, importance: 5 });
121
- service.saveWithDedupe({ type: "summary", title: "总览", content: "总览正文必须带出来", importance: 5 });
122
- const body = text();
123
- assert.ok(body.includes(longPinned), "pin 逐字保真");
124
- assert.ok(body.includes("总览正文必须带出来"), "普通候选照旧拿完整正文:pin 不占共享预算");
125
- });
126
-
127
- test("#249: capability guide registers exactly once, and stays off when the key is absent", () => {
128
- // 这里给的是裸 config(不经 schema 解析),所以「缺键 = 不生效」;生产默认值
129
- // 由 config.js 的 schema 给出(#249 第二批起为 true),那条锁在
130
- // test/inject-parent-gate.test.js。
131
- const off = setup({});
132
- assert.equal(off.sections.length, 0, "缺键 → 不注册提示段");
133
-
134
- const on = setup({ injectGuidanceEnabled: true });
135
- assert.equal(on.sections.length, 1, "exactly one guide section");
136
- assert.equal(on.sections[0].name, "memory-guide");
137
- assert.equal(on.sections[0].order, 150, "插件指引段的既有 order 惯例");
138
- assert.equal(on.sections[0].text, MEMORY_GUIDE_SECTION, "常量文本 → 同会话内稳定");
139
- // 不可逆工具(memory_delete)的克制指引必须在场:这是全 guide 里唯一有数据
140
- // 损失后果的一句,被误删掉的回归要能立刻转红。
141
- assert.ok(MEMORY_GUIDE_SECTION.includes("memory_delete"), "guide keeps the irreversible-tool warning");
142
- // memory_forget 的副作用面同样不能被写窄:工具描述是「挡注入 + 从检索与列表里
143
- // 消失」,只写「只挡注入」会让模型低估它(#249 文案定稿时专门改过这一句)。
144
- assert.ok(
145
- MEMORY_GUIDE_SECTION.includes("memory_forget suppresses it from injection, search results and lists"),
146
- "reversible-tools rule states memory_forget's full reach"
147
- );
148
- // 优先序那条不得让模型拿 memory_search 去核对当前指令/仓库:它只搜记忆库,
149
- // 搜不到「现在」——把它写成验证手段会换来一轮无效查询 + 继续采信陈旧记忆。
150
- assert.ok(
151
- MEMORY_GUIDE_SECTION.includes("memory_search searches stored memories only"),
152
- "precedence rule points at the instruction/repository, not at memory_search"
153
- );
154
- // 不逐轮复读:通则只出现在一次性段落,每轮内容块里不重复。
155
- on.service.saveWithDedupe({ type: "preference", title: "偏好A", content: "偏好内容", importance: 5 });
156
- assert.ok(!on.text().includes("[dsh-mneme memory]"), "guide text must not ride the per-turn block");
157
- });
158
-
159
- test("#249: capability guide extends only the judgement-heavy tool descriptions", () => {
160
- const toolsFor = (flags) => {
161
- const store = createStore(":memory:");
162
- const service = createService({ store, mirror: null, config: {} });
163
- const registered = [];
164
- const ctx = { tools: { register(def) { registered.push(def); return () => {}; } } };
165
- createTools(ctx, service, { ...flags }, null);
166
- return new Map(registered.map((t) => [t.name, t.description]));
167
- };
168
- const off = toolsFor({});
169
- const on = toolsFor({ injectGuidanceEnabled: true });
170
- const changed = [...off.keys()].filter((name) => off.get(name) !== on.get(name)).sort();
171
- assert.deepEqual(changed, ["memory_save", "memory_search"], "only the two 'when to use' tools gain guidance");
172
- for (const name of changed) {
173
- assert.ok(on.get(name).startsWith(off.get(name)), `${name}: guidance is appended, original text untouched`);
174
- }
175
- });
176
-
177
- test("#249: memory_save guidance states the scope default in the safe direction", () => {
178
- // #164 口径:scope 参数漏填的后果是单向的——未标注 = 处处可见(NULL 恒可见),
179
- // 而显式 scope 会让记忆在离开他 scope 时被降权(A2 软隔离 ×0.5,保留可见)或直接
180
- // 过滤(A3 strictScope,默认关)。所以这一句必须同时给出「什么时候标注」与「不确定
181
- // 就都别填」,只写前半句会把模型推向「能填就填」,正好制造那个单向损失。
182
- const store = createStore(":memory:");
183
- const service = createService({ store, mirror: null, config: {} });
184
- const registered = [];
185
- createTools({ tools: { register(def) { registered.push(def); return () => {}; } } }, service, { injectGuidanceEnabled: true }, null);
186
- const text = registered.find((t) => t.name === "memory_save").description;
187
- assert.ok(text.includes("declare workspace_scope / agent_scope"), "scope declaration rule is present");
188
- assert.ok(text.includes("otherwise leave both out"), "the no-scope default is stated, not just the declare case");
189
- // 措辞回归锁:默认配置(strictScope 关)下他 scope 只是降权可见,不是消失。写成
190
- // 「静默消失」既是错的,也会造出本来不存在的隐私预期。
191
- assert.ok(!text.includes("silently disappears"), "must not claim a narrowed memory disappears silently");
192
- // 回归锁:这句话不能只落在总则里(工具描述才是常驻、零注入成本的那个承载位)。
193
- assert.ok(!MEMORY_GUIDE_SECTION.includes("declare workspace_scope / agent_scope"), "scope rule stays a per-tool rule, not a sixth general rule");
194
- });
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 { createInjector } from "../src/inject.js";
6
+ import { createSettings } from "../src/settings.js";
7
+ import { createTools } from "../src/tools.js";
8
+ import { MEMORY_GUIDE_SECTION } from "../src/guide.js";
9
+
10
+ // 回归(issue #249 第一批):注入形态的两件事——
11
+ // ①能力说明(injectGuidanceEnabled):工具描述补判断指引 + order 150 一次性
12
+ // 总则段(常驻段必须同会话稳定,不逐轮复读);
13
+ // ②B1 pin 池(pinnedInjectBudget):约束/偏好不进相关性竞争与跨轮轮换、逐字
14
+ // 保真、排在块内排序之前,且有独立小预算(不占 maxInjectedItems 名额)。
15
+ // 本文件给的是裸 config,两个键缺省时都按关/零算:能力说明的解析默认值由 config.js
16
+ // 的 schema 给出(#249 第二批起为开,另见 test/inject-parent-gate.test.js),pin 池
17
+ // 的默认值是 0。
18
+
19
+ const userMsg = (text) => ({
20
+ type: "user/message",
21
+ data: { source: { kind: "user" }, content: [{ type: "text", text }] }
22
+ });
23
+
24
+ function setup(over = {}) {
25
+ const store = createStore(":memory:");
26
+ // 同一份 config 同时交给 service 与 injector——生产里是同一个 cfg 对象,
27
+ // 而 pin 池的预算读取发生在 service 内、能力说明的开关读取发生在 injector 内。
28
+ const config = { maxInjectedItems: 3, importanceThreshold: 3, ...over };
29
+ const service = createService({ store, mirror: null, config });
30
+ const settings = createSettings(store.db);
31
+ const contexts = [];
32
+ const sections = [];
33
+ const ctx = {
34
+ systemPrompt: {
35
+ context(def) { contexts.push(def); return () => {}; },
36
+ section(def) { sections.push(def); return () => {}; }
37
+ }
38
+ };
39
+ createInjector(ctx, service, settings, config);
40
+ const text = (query = "") => contexts[0].text({
41
+ agent: { session: { id: "s1", snapshotEvents: () => (query ? [userMsg(query)] : []) } }
42
+ });
43
+ return { store, service, contexts, sections, text };
44
+ }
45
+
46
+ const types = (body) => [...body.matchAll(/- \[(\w+)\]/g)].map((m) => m[1]);
47
+ const leadPreference = (body) => body.match(/- \[preference\] ([^((]*)/)?.[1]?.trim();
48
+
49
+ test("#249: default (pinned budget 0) keeps the legacy order and adds no annotation", () => {
50
+ const { service, text } = setup({});
51
+ service.saveWithDedupe({ type: "summary", title: "总览", content: "总览内容", importance: 5 });
52
+ service.saveWithDedupe({ type: "preference", title: "偏好A", content: "偏好内容", importance: 5 });
53
+ const body = text();
54
+ // 现状档位:蒸馏摘要(0) 先于偏好(1)。pin 关闭时不得出现「偏好前置」这一改动。
55
+ assert.deepEqual(types(body), ["summary", "preference"], "budget 0 → legacy priority order");
56
+ assert.ok(!body.includes("未展示"), "pool off → no overflow annotation");
57
+ });
58
+
59
+ test("#249: pinned entries lead the block and sit outside maxInjectedItems", () => {
60
+ const { service, text } = setup({ maxInjectedItems: 2, pinnedInjectBudget: 2 });
61
+ service.saveWithDedupe({ type: "summary", title: "总览", content: "总览内容", importance: 5 });
62
+ service.saveWithDedupe({ type: "preference", title: "偏好A", content: "偏好甲内容", importance: 5 });
63
+ service.saveWithDedupe({ type: "preference", title: "偏好B", content: "偏好乙内容", importance: 5 });
64
+ service.saveWithDedupe({ type: "decision", title: "决定甲", content: "决定内容", importance: 5 });
65
+ const body = text();
66
+ const seq = types(body);
67
+ assert.deepEqual(seq.slice(0, 2), ["preference", "preference"], "pin pool leads the block");
68
+ assert.deepEqual(seq.slice(2), ["summary", "decision"], "general slots still fill to maxItems");
69
+ assert.equal(seq.length, 4, "pinned entries do not consume maxInjectedItems slots");
70
+ });
71
+
72
+ test("#249: over-budget pinned entries are annotated with the truly hidden count", () => {
73
+ const { service, text } = setup({ maxInjectedItems: 1, pinnedInjectBudget: 1 });
74
+ for (let i = 0; i < 3; i++) {
75
+ service.saveWithDedupe({ type: "preference", title: `偏好${i}`, content: `第 ${i} 条偏好内容`, importance: 5 });
76
+ }
77
+ const body = text();
78
+ // 3 条同类里 pref0 被 pin、pref1 进了 general 槽(真的在块内),只有 pref2 没展示。
79
+ // 按 eligible - pinned 直接相减会把 pref1 也算成未展示——虚报(#266 评审实测)。
80
+ assert.ok(body.includes("偏好1"), "the over-budget one that made it into a general slot is really shown");
81
+ assert.ok(body.includes("另有 1 条未展示"), `annotation must carry the hidden count: ${body}`);
82
+ assert.ok(!body.includes("另有 2 条"), "no double counting");
83
+ });
84
+
85
+ test("#249: pinned entries are exempt from cross-turn rotation", () => {
86
+ const { service, text } = setup({ maxInjectedItems: 1, pinnedInjectBudget: 1, injectRotationTurns: 2 });
87
+ service.saveWithDedupe({ type: "preference", title: "偏好A", content: "偏好甲内容", importance: 5 });
88
+ service.saveWithDedupe({ type: "preference", title: "偏好B", content: "偏好乙内容", importance: 5 });
89
+ service.saveWithDedupe({ type: "decision", title: "决定甲", content: "决定内容", importance: 5 });
90
+ service.saveWithDedupe({ type: "decision", title: "决定乙", content: "另一决定", importance: 5 });
91
+ const first = leadPreference(text("第一个问题"));
92
+ const second = leadPreference(text("第二个问题"));
93
+ assert.ok(first, "pin entry is rendered in turn 1");
94
+ assert.equal(first, second, "pin stays at the block head across turns (not rotated away)");
95
+ });
96
+
97
+ test("#249: pinned content is verbatim below the hard ceiling", () => {
98
+ const { service, text } = setup({ maxInjectedItems: 1, pinnedInjectBudget: 1, injectContentMaxChars: 60 });
99
+ const long = "约束原文".repeat(60); // 240 chars, 4× the per-entry cap
100
+ service.saveWithDedupe({ type: "preference", title: "长偏好", content: long, importance: 5 });
101
+ const body = text();
102
+ assert.ok(body.includes(long), "240-char pinned body goes in verbatim (injectContentMaxChars does not apply)");
103
+ assert.ok(!body.includes("已截断"), "no truncation hint needed below the ceiling");
104
+ });
105
+
106
+ test("#249: pinned content still honours the hard ceiling and says so", () => {
107
+ const { service, text } = setup({ maxInjectedItems: 1, pinnedInjectBudget: 1 });
108
+ const huge = "超长约束".repeat(900); // 3600 chars
109
+ service.saveWithDedupe({ type: "preference", title: "超长偏好", content: huge, importance: 5 });
110
+ const body = text();
111
+ assert.ok(!body.includes(huge), "a runaway pinned entry cannot flood the standing block");
112
+ assert.ok(body.includes("已截断"), "the cut is reported, never silent");
113
+ });
114
+
115
+ test("#249: pinned content does not eat the general block budget", () => {
116
+ // 一条 pin 就够击穿 MAX_BLOCK(PINNED_CONTENT_MAX 2000 > MAX_BLOCK 1500):pin
117
+ // 若照旧扣共享预算,budget 变负后同一轮的所有普通候选都会被压成标题行。
118
+ const { service, text } = setup({ maxInjectedItems: 2, pinnedInjectBudget: 1 });
119
+ const longPinned = "约束原文".repeat(470); // 1880 字符,仍在 2000 硬顶内(不带截断)
120
+ service.saveWithDedupe({ type: "preference", title: "长约束", content: longPinned, importance: 5 });
121
+ service.saveWithDedupe({ type: "summary", title: "总览", content: "总览正文必须带出来", importance: 5 });
122
+ const body = text();
123
+ assert.ok(body.includes(longPinned), "pin 逐字保真");
124
+ assert.ok(body.includes("总览正文必须带出来"), "普通候选照旧拿完整正文:pin 不占共享预算");
125
+ });
126
+
127
+ test("#249: capability guide registers exactly once, and stays off when the key is absent", () => {
128
+ // 这里给的是裸 config(不经 schema 解析),所以「缺键 = 不生效」;生产默认值
129
+ // 由 config.js 的 schema 给出(#249 第二批起为 true),那条锁在
130
+ // test/inject-parent-gate.test.js。
131
+ const off = setup({});
132
+ assert.equal(off.sections.length, 0, "缺键 → 不注册提示段");
133
+
134
+ const on = setup({ injectGuidanceEnabled: true });
135
+ assert.equal(on.sections.length, 1, "exactly one guide section");
136
+ assert.equal(on.sections[0].name, "memory-guide");
137
+ assert.equal(on.sections[0].order, 150, "插件指引段的既有 order 惯例");
138
+ assert.equal(on.sections[0].text, MEMORY_GUIDE_SECTION, "常量文本 → 同会话内稳定");
139
+ // 不可逆工具(memory_delete)的克制指引必须在场:这是全 guide 里唯一有数据
140
+ // 损失后果的一句,被误删掉的回归要能立刻转红。
141
+ assert.ok(MEMORY_GUIDE_SECTION.includes("memory_delete"), "guide keeps the irreversible-tool warning");
142
+ // memory_forget 的副作用面同样不能被写窄:工具描述是「挡注入 + 从检索与列表里
143
+ // 消失」,只写「只挡注入」会让模型低估它(#249 文案定稿时专门改过这一句)。
144
+ assert.ok(
145
+ MEMORY_GUIDE_SECTION.includes("memory_forget suppresses it from injection, search results and lists"),
146
+ "reversible-tools rule states memory_forget's full reach"
147
+ );
148
+ // 优先序那条不得让模型拿 memory_search 去核对当前指令/仓库:它只搜记忆库,
149
+ // 搜不到「现在」——把它写成验证手段会换来一轮无效查询 + 继续采信陈旧记忆。
150
+ assert.ok(
151
+ MEMORY_GUIDE_SECTION.includes("memory_search searches stored memories only"),
152
+ "precedence rule points at the instruction/repository, not at memory_search"
153
+ );
154
+ // 不逐轮复读:通则只出现在一次性段落,每轮内容块里不重复。
155
+ on.service.saveWithDedupe({ type: "preference", title: "偏好A", content: "偏好内容", importance: 5 });
156
+ assert.ok(!on.text().includes("[dsh-mneme memory]"), "guide text must not ride the per-turn block");
157
+ });
158
+
159
+ test("#249: capability guide extends only the judgement-heavy tool descriptions", () => {
160
+ const toolsFor = (flags) => {
161
+ const store = createStore(":memory:");
162
+ const service = createService({ store, mirror: null, config: {} });
163
+ const registered = [];
164
+ const ctx = { tools: { register(def) { registered.push(def); return () => {}; } } };
165
+ createTools(ctx, service, { ...flags }, null);
166
+ return new Map(registered.map((t) => [t.name, t.description]));
167
+ };
168
+ const off = toolsFor({});
169
+ const on = toolsFor({ injectGuidanceEnabled: true });
170
+ const changed = [...off.keys()].filter((name) => off.get(name) !== on.get(name)).sort();
171
+ assert.deepEqual(changed, ["memory_save", "memory_search"], "only the two 'when to use' tools gain guidance");
172
+ for (const name of changed) {
173
+ assert.ok(on.get(name).startsWith(off.get(name)), `${name}: guidance is appended, original text untouched`);
174
+ }
175
+ });
176
+
177
+ test("#249: memory_save guidance states the scope default in the safe direction", () => {
178
+ // #164 口径:scope 参数漏填的后果是单向的——未标注 = 处处可见(NULL 恒可见),
179
+ // 而显式 scope 会让记忆在离开他 scope 时被降权(A2 软隔离 ×0.5,保留可见)或直接
180
+ // 过滤(A3 strictScope,默认关)。所以这一句必须同时给出「什么时候标注」与「不确定
181
+ // 就都别填」,只写前半句会把模型推向「能填就填」,正好制造那个单向损失。
182
+ const store = createStore(":memory:");
183
+ const service = createService({ store, mirror: null, config: {} });
184
+ const registered = [];
185
+ createTools({ tools: { register(def) { registered.push(def); return () => {}; } } }, service, { injectGuidanceEnabled: true }, null);
186
+ const text = registered.find((t) => t.name === "memory_save").description;
187
+ assert.ok(text.includes("declare workspace_scope / agent_scope"), "scope declaration rule is present");
188
+ assert.ok(text.includes("otherwise leave both out"), "the no-scope default is stated, not just the declare case");
189
+ // 措辞回归锁:默认配置(strictScope 关)下他 scope 只是降权可见,不是消失。写成
190
+ // 「静默消失」既是错的,也会造出本来不存在的隐私预期。
191
+ assert.ok(!text.includes("silently disappears"), "must not claim a narrowed memory disappears silently");
192
+ // 回归锁:这句话不能只落在总则里(工具描述才是常驻、零注入成本的那个承载位)。
193
+ assert.ok(!MEMORY_GUIDE_SECTION.includes("declare workspace_scope / agent_scope"), "scope rule stays a per-tool rule, not a sixth general rule");
194
+ });