@modusensus/dsh-mneme 0.8.3 → 0.8.5

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 (205) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +727 -636
  3. package/bin/cli.mjs +0 -0
  4. package/bin/dsh-mneme-mcp.mjs +510 -0
  5. package/cordis.patch.yml +21 -21
  6. package/lib/api-standalone.js +506 -316
  7. package/lib/api.js +1403 -1316
  8. package/lib/bootstrap.js +211 -0
  9. package/lib/client.js +4657 -4366
  10. package/lib/commands.js +95 -95
  11. package/lib/config.js +615 -510
  12. package/lib/document.js +221 -0
  13. package/lib/dream/clustering.js +118 -118
  14. package/lib/dream/decisions.js +658 -658
  15. package/lib/dream/narratives.js +44 -0
  16. package/lib/dream/sleep.js +702 -700
  17. package/lib/dream.js +147 -16
  18. package/lib/embedding.js +177 -177
  19. package/lib/entities/extractor.js +249 -249
  20. package/lib/guide.js +44 -0
  21. package/lib/heat.js +144 -136
  22. package/lib/hot-memory.js +46 -46
  23. package/lib/index.js +515 -515
  24. package/lib/inject.js +375 -295
  25. package/lib/lang.js +208 -179
  26. package/lib/local-embedder.js +320 -320
  27. package/lib/mirror.js +198 -198
  28. package/lib/organize.js +450 -0
  29. package/lib/quality-filter.js +126 -126
  30. package/lib/recall-stats.js +125 -0
  31. package/lib/reranker.js +269 -269
  32. package/lib/runtime/adopt.js +176 -176
  33. package/lib/runtime/closure.js +172 -172
  34. package/lib/runtime/download.js +247 -247
  35. package/lib/runtime/layout.js +265 -235
  36. package/lib/runtime/loader.js +252 -249
  37. package/lib/runtime/model-fetch.js +361 -361
  38. package/lib/runtime/provision.js +237 -237
  39. package/lib/runtime/tarball.js +130 -130
  40. package/lib/runtime/verify.js +204 -191
  41. package/lib/scope.js +118 -118
  42. package/lib/search/adaptive.js +60 -22
  43. package/lib/search/bm25.js +96 -96
  44. package/lib/service.js +2324 -2087
  45. package/lib/settings.js +459 -420
  46. package/lib/store.js +2549 -2367
  47. package/lib/summarize.js +820 -449
  48. package/lib/tools.js +702 -574
  49. package/lib/vector-index.js +110 -110
  50. package/lib/version-check.js +122 -122
  51. package/package.json +109 -108
  52. package/runtime-manifest.json +526 -596
  53. package/scripts/benchmark-embed.js +201 -201
  54. package/scripts/benchmark-recall.js +199 -199
  55. package/scripts/benchmark-rerank.js +166 -166
  56. package/scripts/build-runtime-manifest.mjs +224 -217
  57. package/scripts/check-sync.js +42 -42
  58. package/scripts/e2e-dsh.js +220 -220
  59. package/scripts/mneme-runtime.mjs +277 -277
  60. package/scripts/stress-dsh.js +255 -255
  61. package/scripts/sync-lib.js +47 -47
  62. package/scripts/sync-test-badge.mjs +67 -61
  63. package/src/api-standalone.js +506 -316
  64. package/src/api.js +1403 -1316
  65. package/src/bootstrap.js +211 -0
  66. package/src/commands.js +95 -95
  67. package/src/config.js +615 -510
  68. package/src/document.js +221 -0
  69. package/src/dream/clustering.js +118 -118
  70. package/src/dream/decisions.js +658 -658
  71. package/src/dream/narratives.js +44 -0
  72. package/src/dream/sleep.js +702 -700
  73. package/src/dream.js +147 -16
  74. package/src/embedding.js +177 -177
  75. package/src/entities/extractor.js +249 -249
  76. package/src/guide.js +44 -0
  77. package/src/heat.js +144 -136
  78. package/src/hot-memory.js +46 -46
  79. package/src/index.js +515 -515
  80. package/src/inject.js +375 -295
  81. package/src/lang.js +208 -179
  82. package/src/local-embedder.js +320 -320
  83. package/src/mirror.js +198 -198
  84. package/src/organize.js +450 -0
  85. package/src/quality-filter.js +126 -126
  86. package/src/recall-stats.js +125 -0
  87. package/src/reranker.js +269 -269
  88. package/src/runtime/adopt.js +176 -176
  89. package/src/runtime/closure.js +172 -172
  90. package/src/runtime/download.js +247 -247
  91. package/src/runtime/layout.js +265 -235
  92. package/src/runtime/loader.js +252 -249
  93. package/src/runtime/model-fetch.js +361 -361
  94. package/src/runtime/provision.js +237 -237
  95. package/src/runtime/tarball.js +130 -130
  96. package/src/runtime/verify.js +204 -191
  97. package/src/scope.js +118 -118
  98. package/src/search/adaptive.js +60 -22
  99. package/src/search/bm25.js +96 -96
  100. package/src/service.js +2324 -2087
  101. package/src/settings.js +459 -420
  102. package/src/store.js +2549 -2367
  103. package/src/summarize.js +820 -449
  104. package/src/tools.js +702 -574
  105. package/src/vector-index.js +110 -110
  106. package/src/version-check.js +122 -122
  107. package/test/adaptive-inject-budget.test.js +85 -0
  108. package/test/api-routes-gaps.test.js +218 -218
  109. package/test/api.test.js +1640 -1482
  110. package/test/audit.test.js +448 -448
  111. package/test/benchmark.test.js +94 -94
  112. package/test/bootstrap.test.js +220 -0
  113. package/test/client.test.js +860 -736
  114. package/test/clustering.test.js +100 -100
  115. package/test/commands.test.js +106 -106
  116. package/test/config.test.js +66 -66
  117. package/test/conflict-freeze.test.js +300 -300
  118. package/test/document.test.js +523 -0
  119. package/test/dream-archive-guardrail.test.js +116 -116
  120. package/test/dream-candidate-hybrid.test.js +281 -281
  121. package/test/dream-coverage-degrade.test.js +86 -86
  122. package/test/dream.test.js +1308 -1254
  123. package/test/embedding-ready.test.js +196 -196
  124. package/test/entities.test.js +547 -547
  125. package/test/entity-recall.test.js +179 -0
  126. package/test/epistemic.test.js +298 -298
  127. package/test/fnew-0112.test.js +311 -311
  128. package/test/fnew-03.test.js +422 -422
  129. package/test/graph-api.test.js +175 -175
  130. package/test/heat.test.js +175 -148
  131. package/test/helpers/dream-mock.js +82 -82
  132. package/test/helpers/peer-worker.mjs +25 -25
  133. package/test/helpers/runtime-source.js +60 -60
  134. package/test/helpers/tar-builder.js +80 -80
  135. package/test/hot-memory.test.js +145 -145
  136. package/test/inject-content-cap.test.js +91 -0
  137. package/test/inject-first-round-bm25.test.js +89 -89
  138. package/test/inject-heat.test.js +61 -0
  139. package/test/inject-pools.test.js +170 -0
  140. package/test/inject-recall.test.js +105 -0
  141. package/test/inject-rotation.test.js +161 -161
  142. package/test/inject.test.js +283 -249
  143. package/test/lang.test.js +87 -87
  144. package/test/lib-smoke.test.js +96 -96
  145. package/test/llm-audit.test.js +462 -309
  146. package/test/llm-message-source.test.js +177 -177
  147. package/test/local-embedder.test.js +249 -249
  148. package/test/mcp-stdio.test.js +385 -0
  149. package/test/mirror-dirty.test.js +424 -424
  150. package/test/mirror-edit-digest.test.js +187 -187
  151. package/test/mirror-generation.test.js +499 -499
  152. package/test/mirror.test.js +249 -249
  153. package/test/narrative-bars.test.js +162 -0
  154. package/test/organize.test.js +418 -0
  155. package/test/peer-blockers.test.js +193 -193
  156. package/test/policy-epoch.test.js +259 -259
  157. package/test/quality-filter.test.js +186 -186
  158. package/test/reasoning-effort.test.js +746 -746
  159. package/test/recall-evals.test.js +235 -235
  160. package/test/recall-layer.test.js +326 -326
  161. package/test/recall-stats.test.js +123 -0
  162. package/test/receipt-chain.test.js +451 -451
  163. package/test/reflection.test.js +226 -226
  164. package/test/reindex-backfill.test.js +62 -62
  165. package/test/reranker-single-logit.test.js +73 -73
  166. package/test/reranker.test.js +197 -197
  167. package/test/resident-status.test.js +83 -0
  168. package/test/runtime-adopt.test.js +206 -206
  169. package/test/runtime-cli.test.js +89 -89
  170. package/test/runtime-closure.test.js +193 -193
  171. package/test/runtime-download.test.js +302 -302
  172. package/test/runtime-layout.test.js +163 -163
  173. package/test/runtime-loader.test.js +255 -237
  174. package/test/runtime-manifest.test.js +159 -158
  175. package/test/runtime-model-fetch.test.js +348 -348
  176. package/test/runtime-provision.test.js +101 -101
  177. package/test/runtime-tarball.test.js +81 -81
  178. package/test/runtime-verify.test.js +279 -214
  179. package/test/scope-candidates.test.js +239 -239
  180. package/test/scope-explicit.test.js +452 -452
  181. package/test/scope-retrieval.test.js +197 -197
  182. package/test/scope-storage.test.js +255 -255
  183. package/test/scope-strict.test.js +231 -231
  184. package/test/search-fusion.test.js +90 -90
  185. package/test/semantic.test.js +124 -124
  186. package/test/service-search.test.js +174 -174
  187. package/test/service.test.js +405 -405
  188. package/test/settings.test.js +261 -261
  189. package/test/skip-invalid-restore.test.js +262 -262
  190. package/test/sleep-action-set.test.js +422 -422
  191. package/test/sleep-heat.test.js +126 -125
  192. package/test/sleep-scheduler-rearm.test.js +89 -89
  193. package/test/sleep.test.js +410 -373
  194. package/test/standalone-api.test.js +544 -359
  195. package/test/store-vector-cache.test.js +98 -98
  196. package/test/store.test.js +396 -383
  197. package/test/stress.test.js +209 -209
  198. package/test/summarize.test.js +1288 -575
  199. package/test/tools-dto-schema-matrix.test.js +325 -0
  200. package/test/tools-memory-get-schema.test.js +65 -65
  201. package/test/tools.test.js +374 -341
  202. package/test/updated-at-semantics.test.js +113 -113
  203. package/test/vector-index.test.js +221 -221
  204. package/test/version-check.test.js +152 -152
  205. package/test/webServer-optional.test.js +82 -82
@@ -1,261 +1,261 @@
1
- import test from "node:test";
2
- import assert from "node:assert/strict";
3
- import { createStore } from "../src/store.js";
4
- import { createSettings } from "../src/settings.js";
5
-
6
- function setup() {
7
- const store = createStore(":memory:");
8
- const settings = createSettings(store.db);
9
- return { store, settings };
10
- }
11
-
12
- test("profile defaults to empty and round-trips", () => {
13
- const { store, settings } = setup();
14
- assert.equal(settings.getProfile(), "");
15
- settings.setProfile("我是后端工程师,偏好简洁代码");
16
- assert.equal(settings.getProfile(), "我是后端工程师,偏好简洁代码");
17
- settings.setProfile("");
18
- assert.equal(settings.getProfile(), "");
19
- store.close();
20
- });
21
-
22
- test("rules default to empty list and round-trip", () => {
23
- const { store, settings } = setup();
24
- assert.deepEqual(settings.getRules(), []);
25
- settings.setRules(["规则一", "规则二"]);
26
- assert.deepEqual(settings.getRules(), ["规则一", "规则二"]);
27
- settings.setRules([]);
28
- assert.deepEqual(settings.getRules(), []);
29
- store.close();
30
- });
31
-
32
- test("rules filters non-string entries", () => {
33
- const { store, settings } = setup();
34
- settings.setRules(["ok", 42, null, "also-ok"]);
35
- assert.deepEqual(settings.getRules(), ["ok", "also-ok"]);
36
- store.close();
37
- });
38
-
39
- test("addCommand stores and lists sorted by name", () => {
40
- const { store, settings } = setup();
41
- settings.addCommand({ name: "banner", description: "b", instruction: "打印横幅" });
42
- settings.addCommand({ name: "agenda", instruction: "列出今日议程" });
43
- const list = settings.listCommands();
44
- assert.equal(list.length, 2);
45
- assert.deepEqual(list.map((c) => c.name), ["agenda", "banner"]);
46
- assert.ok(list[1].id, "has id");
47
- store.close();
48
- });
49
-
50
- test("addCommand replaces existing name", () => {
51
- const { store, settings } = setup();
52
- settings.addCommand({ name: "fmt", instruction: "旧指令" });
53
- const updated = settings.addCommand({ name: "fmt", instruction: "新指令" });
54
- assert.equal(updated.instruction, "新指令");
55
- assert.equal(settings.listCommands().length, 1);
56
- store.close();
57
- });
58
-
59
- test("addCommand rejects invalid names and empty instructions", () => {
60
- const { store, settings } = setup();
61
- assert.throws(() => settings.addCommand({ name: "Bad Name", instruction: "x" }), /command name/);
62
- assert.throws(() => settings.addCommand({ name: "123abc", instruction: "x" }), /command name/);
63
- assert.throws(() => settings.addCommand({ name: "ok", instruction: " " }), /instruction/);
64
- assert.equal(settings.listCommands().length, 0);
65
- store.close();
66
- });
67
-
68
- test("removeCommand removes by id and returns false for missing", () => {
69
- const { store, settings } = setup();
70
- const { id } = settings.addCommand({ name: "tmp", instruction: "x" });
71
- assert.equal(settings.removeCommand(id), true);
72
- assert.equal(settings.removeCommand(id), false);
73
- assert.equal(settings.listCommands().length, 0);
74
- store.close();
75
- });
76
-
77
- test("vector config defaults to undefined and round-trips", () => {
78
- const { store, settings } = setup();
79
- assert.equal(settings.getVectorConfig(), undefined);
80
- const saved = settings.setVectorConfig({
81
- enabled: true,
82
- baseUrl: " https://api.openai.com/v1/ ",
83
- apiKey: " sk-123 ",
84
- model: "text-embedding-3-small"
85
- });
86
- assert.equal(saved.enabled, true);
87
- assert.equal(saved.baseUrl, "https://api.openai.com/v1", "trims baseUrl");
88
- assert.equal(saved.apiKey, "sk-123", "trims apiKey");
89
- assert.equal(saved.model, "text-embedding-3-small");
90
- const read = settings.getVectorConfig();
91
- assert.equal(read.enabled, true);
92
- assert.equal(read.model, "text-embedding-3-small");
93
- store.close();
94
- });
95
-
96
- test("vector config disabled value is stored as false", () => {
97
- const { store, settings } = setup();
98
- settings.setVectorConfig({ enabled: false, baseUrl: "x", apiKey: "k", model: "m" });
99
- assert.equal(settings.getVectorConfig().enabled, false);
100
- store.close();
101
- });
102
-
103
- test("panel mode defaults to standard and round-trips", () => {
104
- const { store, settings } = setup();
105
- assert.equal(settings.getPanelMode(), "standard");
106
- settings.setPanelMode("light");
107
- assert.equal(settings.getPanelMode(), "light");
108
- settings.setPanelMode("standard");
109
- assert.equal(settings.getPanelMode(), "standard");
110
- store.close();
111
- });
112
-
113
- test("external api settings persist token and merge partial writes", () => {
114
- const { store, settings } = setup();
115
- assert.equal(settings.getExternalApi(), undefined);
116
- settings.setExternalApi({ enabled: true, port: 9000, token: "tok-1" });
117
- assert.deepEqual(settings.getExternalApi(), { enabled: true, port: 9000, host: "127.0.0.1", token: "tok-1" });
118
- // Token-only write preserves the other keys.
119
- settings.setExternalApi({ token: "tok-2" });
120
- assert.deepEqual(settings.getExternalApi(), { enabled: true, port: 9000, host: "127.0.0.1", token: "tok-2" });
121
- // Host write persists and survives the next partial merge.
122
- settings.setExternalApi({ host: "0.0.0.0" });
123
- assert.deepEqual(settings.getExternalApi(), { enabled: true, port: 9000, host: "0.0.0.0", token: "tok-2" });
124
- store.close();
125
- });
126
-
127
- // --- feature flags ---
128
-
129
- test("feature flags default to an empty object", () => {
130
- const { store, settings } = setup();
131
- assert.deepEqual(settings.getFeatureFlags(), {});
132
- store.close();
133
- });
134
-
135
- test("setFeatureFlags rejects unknown keys and persists nothing", () => {
136
- const { store, settings } = setup();
137
- settings.setFeatureFlags({ autoDream: false });
138
- assert.throws(() => settings.setFeatureFlags({ noSuchFlag: true }), TypeError);
139
- assert.throws(() => settings.setFeatureFlags({ noSuchFlag: true }), /noSuchFlag/);
140
- // 被拒的 patch 不落库,已存的合法值原样保留
141
- assert.deepEqual(settings.getFeatureFlags(), { autoDream: false });
142
- store.close();
143
- });
144
-
145
- test("setFeatureFlags enforces boolean types and integer ranges", () => {
146
- const { store, settings } = setup();
147
- assert.throws(() => settings.setFeatureFlags({ autoInject: "yes" }), /autoInject/);
148
- assert.throws(() => settings.setFeatureFlags({ distillMaxChars: 500 }), /distillMaxChars/);
149
- assert.throws(() => settings.setFeatureFlags({ distillRateLimitRetries: 1.5 }), /distillRateLimitRetries/);
150
- assert.throws(() => settings.setFeatureFlags({ codingBoostFactor: 9 }), /codingBoostFactor/);
151
- assert.deepEqual(settings.getFeatureFlags(), {}, "failed writes persist nothing");
152
- store.close();
153
- });
154
-
155
- test("setFeatureFlags merges partial patches and persists across instances", () => {
156
- const { store, settings } = setup();
157
- settings.setFeatureFlags({ autoDream: false, distillMaxChars: 48000 });
158
- settings.setFeatureFlags({ rerankEnabled: true });
159
- // 同一 kv 上的新实例读回合并结果,证明已真正持久化
160
- const settings2 = createSettings(store.db);
161
- assert.deepEqual(settings2.getFeatureFlags(), { autoDream: false, distillMaxChars: 48000, rerankEnabled: true });
162
- store.close();
163
- });
164
-
165
- test("getFeatureFlags drops unknown and corrupted keys from the kv", () => {
166
- const { store, settings } = setup();
167
- settings.setFeatureFlags({ autoInject: false });
168
- // 模拟旧版本/手改残留:绕过校验直接写脏 kv
169
- store.db.prepare("UPDATE user_settings SET value = ? WHERE key = ?").run(
170
- JSON.stringify({ autoInject: false, legacyFlag: true, autoDream: "yes", distillMaxChars: 999999 }),
171
- "feature_flags"
172
- );
173
- assert.deepEqual(settings.getFeatureFlags(), { autoInject: false });
174
- // 整个 kv 损坏(非 JSON)→ 读回空对象而不是抛错
175
- store.db.prepare("UPDATE user_settings SET value = ? WHERE key = ?").run("not-json", "feature_flags");
176
- assert.deepEqual(settings.getFeatureFlags(), {});
177
- store.close();
178
- });
179
-
180
- test("feature flags accept the new boolean, string, url and enum keys", () => {
181
- const { store, settings } = setup();
182
- settings.setFeatureFlags({
183
- "memoryQualityFilter.enabled": false,
184
- "llmAudit.enabled": false,
185
- bm25SearchEnabled: false,
186
- conflictFreezeEnabled: true,
187
- trustEpistemicWeighting: true,
188
- reflectionFailureTracking: false,
189
- dreamProvider: " siliconflow ",
190
- dreamModel: "deepseek-chat",
191
- localEmbedModel: "Xenova/bge-small-zh-v1.5",
192
- ollamaModel: "nomic-embed-text",
193
- ollamaBaseUrl: "http://127.0.0.1:11434/",
194
- embedProvider: "ollama"
195
- });
196
- const flags = settings.getFeatureFlags();
197
- assert.equal(flags["memoryQualityFilter.enabled"], false, "nested keys stored flat");
198
- assert.equal(flags["llmAudit.enabled"], false);
199
- assert.equal(flags.bm25SearchEnabled, false);
200
- assert.equal(flags.conflictFreezeEnabled, true);
201
- assert.equal(flags.trustEpistemicWeighting, true);
202
- assert.equal(flags.reflectionFailureTracking, false);
203
- assert.equal(flags.dreamProvider, "siliconflow", "string values are trimmed");
204
- assert.equal(flags.dreamModel, "deepseek-chat");
205
- assert.equal(flags.ollamaBaseUrl, "http://127.0.0.1:11434/");
206
- assert.equal(flags.embedProvider, "ollama");
207
- // 同一 kv 上的新实例读回合并结果:点号键按平铺键持久化
208
- const settings2 = createSettings(store.db);
209
- assert.equal(settings2.getFeatureFlags()["memoryQualityFilter.enabled"], false);
210
- assert.equal(settings2.getFeatureFlags().embedProvider, "ollama");
211
- store.close();
212
- });
213
-
214
- test("nested feature flag keys are validated as booleans and rejected otherwise", () => {
215
- const { store, settings } = setup();
216
- assert.throws(() => settings.setFeatureFlags({ "memoryQualityFilter.enabled": "yes" }), /memoryQualityFilter\.enabled/);
217
- assert.throws(() => settings.setFeatureFlags({ "llmAudit.enabled": 1 }), /llmAudit\.enabled/);
218
- assert.deepEqual(settings.getFeatureFlags(), {}, "failed writes persist nothing");
219
- store.close();
220
- });
221
-
222
- test("string feature flags: empty is legal, over-length and enum violations rejected", () => {
223
- const { store, settings } = setup();
224
- // 空字符串合法 = 跟随主对话模型(面板显示 placeholder)
225
- settings.setFeatureFlags({ dreamProvider: "", dreamModel: " " });
226
- assert.equal(settings.getFeatureFlags().dreamProvider, "");
227
- assert.equal(settings.getFeatureFlags().dreamModel, "", "whitespace-only trims to empty");
228
- assert.throws(() => settings.setFeatureFlags({ dreamModel: "x".repeat(201) }), /dreamModel/);
229
- assert.throws(() => settings.setFeatureFlags({ localEmbedModel: 42 }), /localEmbedModel/);
230
- assert.throws(() => settings.setFeatureFlags({ embedProvider: "bogus" }), /embedProvider/);
231
- assert.throws(() => settings.setFeatureFlags({ embedProvider: "OpenAI" }), /embedProvider/, "enum is case-sensitive");
232
- assert.deepEqual(settings.getFeatureFlags(), { dreamProvider: "", dreamModel: "" }, "failed writes persist nothing");
233
- store.close();
234
- });
235
-
236
- test("ollamaBaseUrl accepts empty and http(s) URLs, rejects other protocols", () => {
237
- const { store, settings } = setup();
238
- settings.setFeatureFlags({ ollamaBaseUrl: "" });
239
- assert.equal(settings.getFeatureFlags().ollamaBaseUrl, "", "empty = follow default");
240
- settings.setFeatureFlags({ ollamaBaseUrl: " https://embed.example.com/v1 " });
241
- assert.equal(settings.getFeatureFlags().ollamaBaseUrl, "https://embed.example.com/v1");
242
- assert.throws(() => settings.setFeatureFlags({ ollamaBaseUrl: "ftp://localhost:11434" }), /ollamaBaseUrl/);
243
- assert.throws(() => settings.setFeatureFlags({ ollamaBaseUrl: "file:///etc/passwd" }), /ollamaBaseUrl/);
244
- assert.throws(() => settings.setFeatureFlags({ ollamaBaseUrl: "javascript:alert(1)" }), /ollamaBaseUrl/);
245
- assert.throws(() => settings.setFeatureFlags({ ollamaBaseUrl: "localhost:11434" }), /ollamaBaseUrl/, "protocol is required");
246
- assert.throws(() => settings.setFeatureFlags({ ollamaBaseUrl: "not a url" }), /ollamaBaseUrl/);
247
- assert.equal(settings.getFeatureFlags().ollamaBaseUrl, "https://embed.example.com/v1", "rejected writes persist nothing");
248
- store.close();
249
- });
250
-
251
- test("getFeatureFlags drops corrupted string, url and enum keys from the kv", () => {
252
- const { store, settings } = setup();
253
- settings.setFeatureFlags({ dreamModel: "m", ollamaBaseUrl: "http://localhost:11434", embedProvider: "local" });
254
- // 模拟旧版本/手改残留:字符串键混入非字符串、URL 键混入非法协议、枚举越界
255
- store.db.prepare("UPDATE user_settings SET value = ? WHERE key = ?").run(
256
- JSON.stringify({ dreamModel: 42, ollamaBaseUrl: "ftp://bad", embedProvider: "bogus", autoInject: false }),
257
- "feature_flags"
258
- );
259
- assert.deepEqual(settings.getFeatureFlags(), { autoInject: false });
260
- store.close();
261
- });
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import { createStore } from "../src/store.js";
4
+ import { createSettings } from "../src/settings.js";
5
+
6
+ function setup() {
7
+ const store = createStore(":memory:");
8
+ const settings = createSettings(store.db);
9
+ return { store, settings };
10
+ }
11
+
12
+ test("profile defaults to empty and round-trips", () => {
13
+ const { store, settings } = setup();
14
+ assert.equal(settings.getProfile(), "");
15
+ settings.setProfile("我是后端工程师,偏好简洁代码");
16
+ assert.equal(settings.getProfile(), "我是后端工程师,偏好简洁代码");
17
+ settings.setProfile("");
18
+ assert.equal(settings.getProfile(), "");
19
+ store.close();
20
+ });
21
+
22
+ test("rules default to empty list and round-trip", () => {
23
+ const { store, settings } = setup();
24
+ assert.deepEqual(settings.getRules(), []);
25
+ settings.setRules(["规则一", "规则二"]);
26
+ assert.deepEqual(settings.getRules(), ["规则一", "规则二"]);
27
+ settings.setRules([]);
28
+ assert.deepEqual(settings.getRules(), []);
29
+ store.close();
30
+ });
31
+
32
+ test("rules filters non-string entries", () => {
33
+ const { store, settings } = setup();
34
+ settings.setRules(["ok", 42, null, "also-ok"]);
35
+ assert.deepEqual(settings.getRules(), ["ok", "also-ok"]);
36
+ store.close();
37
+ });
38
+
39
+ test("addCommand stores and lists sorted by name", () => {
40
+ const { store, settings } = setup();
41
+ settings.addCommand({ name: "banner", description: "b", instruction: "打印横幅" });
42
+ settings.addCommand({ name: "agenda", instruction: "列出今日议程" });
43
+ const list = settings.listCommands();
44
+ assert.equal(list.length, 2);
45
+ assert.deepEqual(list.map((c) => c.name), ["agenda", "banner"]);
46
+ assert.ok(list[1].id, "has id");
47
+ store.close();
48
+ });
49
+
50
+ test("addCommand replaces existing name", () => {
51
+ const { store, settings } = setup();
52
+ settings.addCommand({ name: "fmt", instruction: "旧指令" });
53
+ const updated = settings.addCommand({ name: "fmt", instruction: "新指令" });
54
+ assert.equal(updated.instruction, "新指令");
55
+ assert.equal(settings.listCommands().length, 1);
56
+ store.close();
57
+ });
58
+
59
+ test("addCommand rejects invalid names and empty instructions", () => {
60
+ const { store, settings } = setup();
61
+ assert.throws(() => settings.addCommand({ name: "Bad Name", instruction: "x" }), /command name/);
62
+ assert.throws(() => settings.addCommand({ name: "123abc", instruction: "x" }), /command name/);
63
+ assert.throws(() => settings.addCommand({ name: "ok", instruction: " " }), /instruction/);
64
+ assert.equal(settings.listCommands().length, 0);
65
+ store.close();
66
+ });
67
+
68
+ test("removeCommand removes by id and returns false for missing", () => {
69
+ const { store, settings } = setup();
70
+ const { id } = settings.addCommand({ name: "tmp", instruction: "x" });
71
+ assert.equal(settings.removeCommand(id), true);
72
+ assert.equal(settings.removeCommand(id), false);
73
+ assert.equal(settings.listCommands().length, 0);
74
+ store.close();
75
+ });
76
+
77
+ test("vector config defaults to undefined and round-trips", () => {
78
+ const { store, settings } = setup();
79
+ assert.equal(settings.getVectorConfig(), undefined);
80
+ const saved = settings.setVectorConfig({
81
+ enabled: true,
82
+ baseUrl: " https://api.openai.com/v1/ ",
83
+ apiKey: " sk-123 ",
84
+ model: "text-embedding-3-small"
85
+ });
86
+ assert.equal(saved.enabled, true);
87
+ assert.equal(saved.baseUrl, "https://api.openai.com/v1", "trims baseUrl");
88
+ assert.equal(saved.apiKey, "sk-123", "trims apiKey");
89
+ assert.equal(saved.model, "text-embedding-3-small");
90
+ const read = settings.getVectorConfig();
91
+ assert.equal(read.enabled, true);
92
+ assert.equal(read.model, "text-embedding-3-small");
93
+ store.close();
94
+ });
95
+
96
+ test("vector config disabled value is stored as false", () => {
97
+ const { store, settings } = setup();
98
+ settings.setVectorConfig({ enabled: false, baseUrl: "x", apiKey: "k", model: "m" });
99
+ assert.equal(settings.getVectorConfig().enabled, false);
100
+ store.close();
101
+ });
102
+
103
+ test("panel mode defaults to standard and round-trips", () => {
104
+ const { store, settings } = setup();
105
+ assert.equal(settings.getPanelMode(), "standard");
106
+ settings.setPanelMode("light");
107
+ assert.equal(settings.getPanelMode(), "light");
108
+ settings.setPanelMode("standard");
109
+ assert.equal(settings.getPanelMode(), "standard");
110
+ store.close();
111
+ });
112
+
113
+ test("external api settings persist token and merge partial writes", () => {
114
+ const { store, settings } = setup();
115
+ assert.equal(settings.getExternalApi(), undefined);
116
+ settings.setExternalApi({ enabled: true, port: 9000, token: "tok-1" });
117
+ assert.deepEqual(settings.getExternalApi(), { enabled: true, port: 9000, host: "127.0.0.1", token: "tok-1" });
118
+ // Token-only write preserves the other keys.
119
+ settings.setExternalApi({ token: "tok-2" });
120
+ assert.deepEqual(settings.getExternalApi(), { enabled: true, port: 9000, host: "127.0.0.1", token: "tok-2" });
121
+ // Host write persists and survives the next partial merge.
122
+ settings.setExternalApi({ host: "0.0.0.0" });
123
+ assert.deepEqual(settings.getExternalApi(), { enabled: true, port: 9000, host: "0.0.0.0", token: "tok-2" });
124
+ store.close();
125
+ });
126
+
127
+ // --- feature flags ---
128
+
129
+ test("feature flags default to an empty object", () => {
130
+ const { store, settings } = setup();
131
+ assert.deepEqual(settings.getFeatureFlags(), {});
132
+ store.close();
133
+ });
134
+
135
+ test("setFeatureFlags rejects unknown keys and persists nothing", () => {
136
+ const { store, settings } = setup();
137
+ settings.setFeatureFlags({ autoDream: false });
138
+ assert.throws(() => settings.setFeatureFlags({ noSuchFlag: true }), TypeError);
139
+ assert.throws(() => settings.setFeatureFlags({ noSuchFlag: true }), /noSuchFlag/);
140
+ // 被拒的 patch 不落库,已存的合法值原样保留
141
+ assert.deepEqual(settings.getFeatureFlags(), { autoDream: false });
142
+ store.close();
143
+ });
144
+
145
+ test("setFeatureFlags enforces boolean types and integer ranges", () => {
146
+ const { store, settings } = setup();
147
+ assert.throws(() => settings.setFeatureFlags({ autoInject: "yes" }), /autoInject/);
148
+ assert.throws(() => settings.setFeatureFlags({ distillMaxChars: 500 }), /distillMaxChars/);
149
+ assert.throws(() => settings.setFeatureFlags({ distillRateLimitRetries: 1.5 }), /distillRateLimitRetries/);
150
+ assert.throws(() => settings.setFeatureFlags({ codingBoostFactor: 9 }), /codingBoostFactor/);
151
+ assert.deepEqual(settings.getFeatureFlags(), {}, "failed writes persist nothing");
152
+ store.close();
153
+ });
154
+
155
+ test("setFeatureFlags merges partial patches and persists across instances", () => {
156
+ const { store, settings } = setup();
157
+ settings.setFeatureFlags({ autoDream: false, distillMaxChars: 48000 });
158
+ settings.setFeatureFlags({ rerankEnabled: true });
159
+ // 同一 kv 上的新实例读回合并结果,证明已真正持久化
160
+ const settings2 = createSettings(store.db);
161
+ assert.deepEqual(settings2.getFeatureFlags(), { autoDream: false, distillMaxChars: 48000, rerankEnabled: true });
162
+ store.close();
163
+ });
164
+
165
+ test("getFeatureFlags drops unknown and corrupted keys from the kv", () => {
166
+ const { store, settings } = setup();
167
+ settings.setFeatureFlags({ autoInject: false });
168
+ // 模拟旧版本/手改残留:绕过校验直接写脏 kv
169
+ store.db.prepare("UPDATE user_settings SET value = ? WHERE key = ?").run(
170
+ JSON.stringify({ autoInject: false, legacyFlag: true, autoDream: "yes", distillMaxChars: 999999 }),
171
+ "feature_flags"
172
+ );
173
+ assert.deepEqual(settings.getFeatureFlags(), { autoInject: false });
174
+ // 整个 kv 损坏(非 JSON)→ 读回空对象而不是抛错
175
+ store.db.prepare("UPDATE user_settings SET value = ? WHERE key = ?").run("not-json", "feature_flags");
176
+ assert.deepEqual(settings.getFeatureFlags(), {});
177
+ store.close();
178
+ });
179
+
180
+ test("feature flags accept the new boolean, string, url and enum keys", () => {
181
+ const { store, settings } = setup();
182
+ settings.setFeatureFlags({
183
+ "memoryQualityFilter.enabled": false,
184
+ "llmAudit.enabled": false,
185
+ bm25SearchEnabled: false,
186
+ conflictFreezeEnabled: true,
187
+ trustEpistemicWeighting: true,
188
+ reflectionFailureTracking: false,
189
+ dreamProvider: " siliconflow ",
190
+ dreamModel: "deepseek-chat",
191
+ localEmbedModel: "Xenova/bge-small-zh-v1.5",
192
+ ollamaModel: "nomic-embed-text",
193
+ ollamaBaseUrl: "http://127.0.0.1:11434/",
194
+ embedProvider: "ollama"
195
+ });
196
+ const flags = settings.getFeatureFlags();
197
+ assert.equal(flags["memoryQualityFilter.enabled"], false, "nested keys stored flat");
198
+ assert.equal(flags["llmAudit.enabled"], false);
199
+ assert.equal(flags.bm25SearchEnabled, false);
200
+ assert.equal(flags.conflictFreezeEnabled, true);
201
+ assert.equal(flags.trustEpistemicWeighting, true);
202
+ assert.equal(flags.reflectionFailureTracking, false);
203
+ assert.equal(flags.dreamProvider, "siliconflow", "string values are trimmed");
204
+ assert.equal(flags.dreamModel, "deepseek-chat");
205
+ assert.equal(flags.ollamaBaseUrl, "http://127.0.0.1:11434/");
206
+ assert.equal(flags.embedProvider, "ollama");
207
+ // 同一 kv 上的新实例读回合并结果:点号键按平铺键持久化
208
+ const settings2 = createSettings(store.db);
209
+ assert.equal(settings2.getFeatureFlags()["memoryQualityFilter.enabled"], false);
210
+ assert.equal(settings2.getFeatureFlags().embedProvider, "ollama");
211
+ store.close();
212
+ });
213
+
214
+ test("nested feature flag keys are validated as booleans and rejected otherwise", () => {
215
+ const { store, settings } = setup();
216
+ assert.throws(() => settings.setFeatureFlags({ "memoryQualityFilter.enabled": "yes" }), /memoryQualityFilter\.enabled/);
217
+ assert.throws(() => settings.setFeatureFlags({ "llmAudit.enabled": 1 }), /llmAudit\.enabled/);
218
+ assert.deepEqual(settings.getFeatureFlags(), {}, "failed writes persist nothing");
219
+ store.close();
220
+ });
221
+
222
+ test("string feature flags: empty is legal, over-length and enum violations rejected", () => {
223
+ const { store, settings } = setup();
224
+ // 空字符串合法 = 跟随主对话模型(面板显示 placeholder)
225
+ settings.setFeatureFlags({ dreamProvider: "", dreamModel: " " });
226
+ assert.equal(settings.getFeatureFlags().dreamProvider, "");
227
+ assert.equal(settings.getFeatureFlags().dreamModel, "", "whitespace-only trims to empty");
228
+ assert.throws(() => settings.setFeatureFlags({ dreamModel: "x".repeat(201) }), /dreamModel/);
229
+ assert.throws(() => settings.setFeatureFlags({ localEmbedModel: 42 }), /localEmbedModel/);
230
+ assert.throws(() => settings.setFeatureFlags({ embedProvider: "bogus" }), /embedProvider/);
231
+ assert.throws(() => settings.setFeatureFlags({ embedProvider: "OpenAI" }), /embedProvider/, "enum is case-sensitive");
232
+ assert.deepEqual(settings.getFeatureFlags(), { dreamProvider: "", dreamModel: "" }, "failed writes persist nothing");
233
+ store.close();
234
+ });
235
+
236
+ test("ollamaBaseUrl accepts empty and http(s) URLs, rejects other protocols", () => {
237
+ const { store, settings } = setup();
238
+ settings.setFeatureFlags({ ollamaBaseUrl: "" });
239
+ assert.equal(settings.getFeatureFlags().ollamaBaseUrl, "", "empty = follow default");
240
+ settings.setFeatureFlags({ ollamaBaseUrl: " https://embed.example.com/v1 " });
241
+ assert.equal(settings.getFeatureFlags().ollamaBaseUrl, "https://embed.example.com/v1");
242
+ assert.throws(() => settings.setFeatureFlags({ ollamaBaseUrl: "ftp://localhost:11434" }), /ollamaBaseUrl/);
243
+ assert.throws(() => settings.setFeatureFlags({ ollamaBaseUrl: "file:///etc/passwd" }), /ollamaBaseUrl/);
244
+ assert.throws(() => settings.setFeatureFlags({ ollamaBaseUrl: "javascript:alert(1)" }), /ollamaBaseUrl/);
245
+ assert.throws(() => settings.setFeatureFlags({ ollamaBaseUrl: "localhost:11434" }), /ollamaBaseUrl/, "protocol is required");
246
+ assert.throws(() => settings.setFeatureFlags({ ollamaBaseUrl: "not a url" }), /ollamaBaseUrl/);
247
+ assert.equal(settings.getFeatureFlags().ollamaBaseUrl, "https://embed.example.com/v1", "rejected writes persist nothing");
248
+ store.close();
249
+ });
250
+
251
+ test("getFeatureFlags drops corrupted string, url and enum keys from the kv", () => {
252
+ const { store, settings } = setup();
253
+ settings.setFeatureFlags({ dreamModel: "m", ollamaBaseUrl: "http://localhost:11434", embedProvider: "local" });
254
+ // 模拟旧版本/手改残留:字符串键混入非字符串、URL 键混入非法协议、枚举越界
255
+ store.db.prepare("UPDATE user_settings SET value = ? WHERE key = ?").run(
256
+ JSON.stringify({ dreamModel: 42, ollamaBaseUrl: "ftp://bad", embedProvider: "bogus", autoInject: false }),
257
+ "feature_flags"
258
+ );
259
+ assert.deepEqual(settings.getFeatureFlags(), { autoInject: false });
260
+ store.close();
261
+ });