@modusensus/dsh-mneme 0.8.3 → 0.8.4

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 (193) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +718 -636
  3. package/bin/cli.mjs +0 -0
  4. package/bin/dsh-mneme-mcp.mjs +502 -0
  5. package/cordis.patch.yml +21 -21
  6. package/lib/api-standalone.js +495 -316
  7. package/lib/api.js +1382 -1316
  8. package/lib/bootstrap.js +211 -0
  9. package/lib/client.js +4475 -4366
  10. package/lib/commands.js +95 -95
  11. package/lib/config.js +533 -510
  12. package/lib/dream/clustering.js +118 -118
  13. package/lib/dream/decisions.js +658 -658
  14. package/lib/dream/narratives.js +44 -0
  15. package/lib/dream/sleep.js +700 -700
  16. package/lib/dream.js +1319 -1216
  17. package/lib/embedding.js +177 -177
  18. package/lib/entities/extractor.js +249 -249
  19. package/lib/heat.js +142 -136
  20. package/lib/hot-memory.js +46 -46
  21. package/lib/index.js +515 -515
  22. package/lib/inject.js +299 -295
  23. package/lib/lang.js +202 -179
  24. package/lib/local-embedder.js +320 -320
  25. package/lib/mirror.js +198 -198
  26. package/lib/quality-filter.js +126 -126
  27. package/lib/recall-stats.js +103 -0
  28. package/lib/reranker.js +269 -269
  29. package/lib/runtime/adopt.js +176 -176
  30. package/lib/runtime/closure.js +172 -172
  31. package/lib/runtime/download.js +247 -247
  32. package/lib/runtime/layout.js +235 -235
  33. package/lib/runtime/loader.js +249 -249
  34. package/lib/runtime/model-fetch.js +361 -361
  35. package/lib/runtime/provision.js +237 -237
  36. package/lib/runtime/tarball.js +130 -130
  37. package/lib/runtime/verify.js +191 -191
  38. package/lib/scope.js +118 -118
  39. package/lib/search/adaptive.js +22 -22
  40. package/lib/search/bm25.js +96 -96
  41. package/lib/service.js +2171 -2087
  42. package/lib/settings.js +430 -420
  43. package/lib/store.js +2448 -2367
  44. package/lib/summarize.js +575 -449
  45. package/lib/tools.js +574 -574
  46. package/lib/vector-index.js +110 -110
  47. package/lib/version-check.js +122 -122
  48. package/package.json +109 -108
  49. package/runtime-manifest.json +596 -596
  50. package/scripts/benchmark-embed.js +201 -201
  51. package/scripts/benchmark-recall.js +199 -199
  52. package/scripts/benchmark-rerank.js +166 -166
  53. package/scripts/build-runtime-manifest.mjs +217 -217
  54. package/scripts/check-sync.js +42 -42
  55. package/scripts/e2e-dsh.js +220 -220
  56. package/scripts/mneme-runtime.mjs +277 -277
  57. package/scripts/stress-dsh.js +255 -255
  58. package/scripts/sync-lib.js +47 -47
  59. package/scripts/sync-test-badge.mjs +61 -61
  60. package/src/api-standalone.js +495 -316
  61. package/src/api.js +1382 -1316
  62. package/src/bootstrap.js +211 -0
  63. package/src/commands.js +95 -95
  64. package/src/config.js +533 -510
  65. package/src/dream/clustering.js +118 -118
  66. package/src/dream/decisions.js +658 -658
  67. package/src/dream/narratives.js +44 -0
  68. package/src/dream/sleep.js +700 -700
  69. package/src/dream.js +1319 -1216
  70. package/src/embedding.js +177 -177
  71. package/src/entities/extractor.js +249 -249
  72. package/src/heat.js +142 -136
  73. package/src/hot-memory.js +46 -46
  74. package/src/index.js +515 -515
  75. package/src/inject.js +299 -295
  76. package/src/lang.js +202 -179
  77. package/src/local-embedder.js +320 -320
  78. package/src/mirror.js +198 -198
  79. package/src/quality-filter.js +126 -126
  80. package/src/recall-stats.js +103 -0
  81. package/src/reranker.js +269 -269
  82. package/src/runtime/adopt.js +176 -176
  83. package/src/runtime/closure.js +172 -172
  84. package/src/runtime/download.js +247 -247
  85. package/src/runtime/layout.js +235 -235
  86. package/src/runtime/loader.js +249 -249
  87. package/src/runtime/model-fetch.js +361 -361
  88. package/src/runtime/provision.js +237 -237
  89. package/src/runtime/tarball.js +130 -130
  90. package/src/runtime/verify.js +191 -191
  91. package/src/scope.js +118 -118
  92. package/src/search/adaptive.js +22 -22
  93. package/src/search/bm25.js +96 -96
  94. package/src/service.js +2171 -2087
  95. package/src/settings.js +430 -420
  96. package/src/store.js +2448 -2367
  97. package/src/summarize.js +575 -449
  98. package/src/tools.js +574 -574
  99. package/src/vector-index.js +110 -110
  100. package/src/version-check.js +122 -122
  101. package/test/api-routes-gaps.test.js +218 -218
  102. package/test/api.test.js +1578 -1482
  103. package/test/audit.test.js +448 -448
  104. package/test/benchmark.test.js +94 -94
  105. package/test/bootstrap.test.js +220 -0
  106. package/test/client.test.js +799 -736
  107. package/test/clustering.test.js +100 -100
  108. package/test/commands.test.js +106 -106
  109. package/test/config.test.js +66 -66
  110. package/test/conflict-freeze.test.js +300 -300
  111. package/test/dream-archive-guardrail.test.js +116 -116
  112. package/test/dream-candidate-hybrid.test.js +281 -281
  113. package/test/dream-coverage-degrade.test.js +86 -86
  114. package/test/dream.test.js +1257 -1254
  115. package/test/embedding-ready.test.js +196 -196
  116. package/test/entities.test.js +547 -547
  117. package/test/entity-recall.test.js +179 -0
  118. package/test/epistemic.test.js +298 -298
  119. package/test/fnew-0112.test.js +311 -311
  120. package/test/fnew-03.test.js +422 -422
  121. package/test/graph-api.test.js +175 -175
  122. package/test/heat.test.js +175 -148
  123. package/test/helpers/dream-mock.js +82 -82
  124. package/test/helpers/peer-worker.mjs +25 -25
  125. package/test/helpers/runtime-source.js +60 -60
  126. package/test/helpers/tar-builder.js +80 -80
  127. package/test/hot-memory.test.js +145 -145
  128. package/test/inject-content-cap.test.js +89 -0
  129. package/test/inject-first-round-bm25.test.js +89 -89
  130. package/test/inject-heat.test.js +61 -0
  131. package/test/inject-rotation.test.js +161 -161
  132. package/test/inject.test.js +249 -249
  133. package/test/lang.test.js +87 -87
  134. package/test/lib-smoke.test.js +96 -96
  135. package/test/llm-audit.test.js +309 -309
  136. package/test/llm-message-source.test.js +177 -177
  137. package/test/local-embedder.test.js +249 -249
  138. package/test/mcp-stdio.test.js +385 -0
  139. package/test/mirror-dirty.test.js +424 -424
  140. package/test/mirror-edit-digest.test.js +187 -187
  141. package/test/mirror-generation.test.js +499 -499
  142. package/test/mirror.test.js +249 -249
  143. package/test/narrative-bars.test.js +162 -0
  144. package/test/peer-blockers.test.js +193 -193
  145. package/test/policy-epoch.test.js +259 -259
  146. package/test/quality-filter.test.js +186 -186
  147. package/test/reasoning-effort.test.js +746 -746
  148. package/test/recall-evals.test.js +235 -235
  149. package/test/recall-layer.test.js +326 -326
  150. package/test/recall-stats.test.js +117 -0
  151. package/test/receipt-chain.test.js +451 -451
  152. package/test/reflection.test.js +226 -226
  153. package/test/reindex-backfill.test.js +62 -62
  154. package/test/reranker-single-logit.test.js +73 -73
  155. package/test/reranker.test.js +197 -197
  156. package/test/resident-status.test.js +83 -0
  157. package/test/runtime-adopt.test.js +206 -206
  158. package/test/runtime-cli.test.js +89 -89
  159. package/test/runtime-closure.test.js +193 -193
  160. package/test/runtime-download.test.js +302 -302
  161. package/test/runtime-layout.test.js +163 -163
  162. package/test/runtime-loader.test.js +237 -237
  163. package/test/runtime-manifest.test.js +158 -158
  164. package/test/runtime-model-fetch.test.js +348 -348
  165. package/test/runtime-provision.test.js +101 -101
  166. package/test/runtime-tarball.test.js +81 -81
  167. package/test/runtime-verify.test.js +214 -214
  168. package/test/scope-candidates.test.js +239 -239
  169. package/test/scope-explicit.test.js +452 -452
  170. package/test/scope-retrieval.test.js +197 -197
  171. package/test/scope-storage.test.js +255 -255
  172. package/test/scope-strict.test.js +231 -231
  173. package/test/search-fusion.test.js +90 -90
  174. package/test/semantic.test.js +124 -124
  175. package/test/service-search.test.js +174 -174
  176. package/test/service.test.js +405 -405
  177. package/test/settings.test.js +261 -261
  178. package/test/skip-invalid-restore.test.js +262 -262
  179. package/test/sleep-action-set.test.js +422 -422
  180. package/test/sleep-heat.test.js +126 -125
  181. package/test/sleep-scheduler-rearm.test.js +89 -89
  182. package/test/sleep.test.js +373 -373
  183. package/test/standalone-api.test.js +544 -359
  184. package/test/store-vector-cache.test.js +98 -98
  185. package/test/store.test.js +383 -383
  186. package/test/stress.test.js +209 -209
  187. package/test/summarize.test.js +884 -575
  188. package/test/tools-memory-get-schema.test.js +65 -65
  189. package/test/tools.test.js +341 -341
  190. package/test/updated-at-semantics.test.js +113 -113
  191. package/test/vector-index.test.js +221 -221
  192. package/test/version-check.test.js +152 -152
  193. 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
+ });