@modusensus/dsh-mneme 0.8.14 → 0.8.16

package/test/clustering.test.js

@@ -1,100 +1,100 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import { cosineSimilarity, kMeans, clusterMemories, findPotentialConflicts } from "../src/dream/clustering.js";
-
-test("cosineSimilarity: identical vectors => 1", () => {
-  assert.equal(cosineSimilarity([1, 2, 3], [1, 2, 3]), 1);
-});
-
-test("cosineSimilarity: orthogonal vectors => 0 (approx)", () => {
-  assert.ok(Math.abs(cosineSimilarity([1, 0], [0, 1])) < 1e-9);
-});
-
-test("cosineSimilarity: mismatched or empty lengths => 0", () => {
-  assert.equal(cosineSimilarity([1, 2], [1, 2, 3]), 0);
-  assert.equal(cosineSimilarity([], []), 0);
-});
-
-test("cosineSimilarity: zero-norm vector => 0", () => {
-  assert.equal(cosineSimilarity([0, 0], [1, 1]), 0);
-});
-
-// Three well-separated point groups in the plane.
-const GROUP1 = [[0, 0], [0, 0.1], [0.1, 0], [0.1, 0.1]];
-const GROUP2 = [[10, 10], [10, 10.1], [10.1, 10], [10.1, 10.1]];
-const GROUP3 = [[-10, -10], [-10, -9.9], [-9.9, -10], [-9.9, -9.9]];
-const SEPARATED = [...GROUP1, ...GROUP2, ...GROUP3];
-
-test("kMeans: three separated groups cluster correctly (labels may permute)", () => {
-  const clusters = kMeans(SEPARATED, 3, { maxIter: 100 });
-  assert.equal(clusters.length, 3);
-  // Content-based check: each cluster must fit exactly one expected group.
-  const expectedGroups = [[0, 1, 2, 3], [4, 5, 6, 7], [8, 9, 10, 11]];
-  for (const c of clusters) {
-    assert.ok(c.length >= 1);
-    const fits = expectedGroups.filter((g) => c.every((idx) => g.includes(idx)));
-    assert.equal(fits.length, 1, `cluster ${JSON.stringify(c)} spans multiple groups`);
-  }
-  // Every index assigned exactly once.
-  assert.deepEqual(clusters.flat().sort((a, b) => a - b), [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]);
-});
-
-test("kMeans: k >= n returns a single cluster of all indices", () => {
-  assert.deepEqual(kMeans(SEPARATED, 12), [[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]]);
-  assert.deepEqual(kMeans(SEPARATED, 0), [[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]]);
-});
-
-test("kMeans: empty input => no clusters", () => {
-  assert.deepEqual(kMeans([], 3), []);
-});
-
-test("kMeans: empty clusters get reseeded and still terminate", () => {
-  // Many points near two poles with k=3 forces one cluster empty on seed.
-  const vectors = [
-    ...Array.from({ length: 30 }, () => [0, 0]),
-    ...Array.from({ length: 30 }, () => [1, 1])
-  ];
-  const clusters = kMeans(vectors, 3, { maxIter: 50 });
-  assert.equal(clusters.length, 3);
-  assert.equal(clusters.flat().length, vectors.length);
-});
-
-test("clusterMemories: preserves object references and group count", () => {
-  const memories = SEPARATED.map((v, i) => ({ id: `m${i}`, type: "project", title: `t${i}` }));
-  const groups = clusterMemories(memories, SEPARATED, 3);
-  assert.equal(groups.length, 3);
-  assert.equal(groups.flat().length, memories.length);
-  // Reference identity preserved: every group member is an object from input.
-  const all = groups.flat();
-  for (const m of all) assert.ok(memories.includes(m), "cluster contains a foreign object");
-  // Full coverage: each source object appears exactly once across groups.
-  assert.equal(new Set(all).size, memories.length);
-  assert.equal(groups.flat().find((m) => m.id === "m5"), memories[5]);
-});
-
-test("findPotentialConflicts: only same-type highly-similar pairs reported", () => {
-  const memories = [
-    { id: "a", type: "preference", content: "like cold coffee" },
-    { id: "b", type: "preference", content: "hate cold coffee" },
-    { id: "c", type: "project", content: "ship the plugin" }
-  ];
-  const vectors = [
-    [1, 0, 0],
-    [0.99, 0.02, 0],   // nearly parallel to a, same type => conflict
-    [0, 1, 0]          // different type, ignored even if near
-  ];
-  const pairs = findPotentialConflicts(memories, vectors, 0.85);
-  assert.equal(pairs.length, 1);
-  assert.equal(pairs[0].a, memories[0]);
-  assert.equal(pairs[0].b, memories[1]);
-  assert.ok(pairs[0].similarity > 0.85);
-});
-
-test("findPotentialConflicts: below threshold or different type => no pairs", () => {
-  const memories = [
-    { id: "x", type: "preference" },
-    { id: "y", type: "project" }
-  ];
-  assert.deepEqual(findPotentialConflicts(memories, [[1, 0], [0, 1]]), []);
-  assert.deepEqual(findPotentialConflicts(memories, [[1, 0], [0.9, 0.1]], 0.95), []);
-});
+import test from "node:test";
+import assert from "node:assert/strict";
+import { cosineSimilarity, kMeans, clusterMemories, findPotentialConflicts } from "../src/dream/clustering.js";
+
+test("cosineSimilarity: identical vectors => 1", () => {
+  assert.equal(cosineSimilarity([1, 2, 3], [1, 2, 3]), 1);
+});
+
+test("cosineSimilarity: orthogonal vectors => 0 (approx)", () => {
+  assert.ok(Math.abs(cosineSimilarity([1, 0], [0, 1])) < 1e-9);
+});
+
+test("cosineSimilarity: mismatched or empty lengths => 0", () => {
+  assert.equal(cosineSimilarity([1, 2], [1, 2, 3]), 0);
+  assert.equal(cosineSimilarity([], []), 0);
+});
+
+test("cosineSimilarity: zero-norm vector => 0", () => {
+  assert.equal(cosineSimilarity([0, 0], [1, 1]), 0);
+});
+
+// Three well-separated point groups in the plane.
+const GROUP1 = [[0, 0], [0, 0.1], [0.1, 0], [0.1, 0.1]];
+const GROUP2 = [[10, 10], [10, 10.1], [10.1, 10], [10.1, 10.1]];
+const GROUP3 = [[-10, -10], [-10, -9.9], [-9.9, -10], [-9.9, -9.9]];
+const SEPARATED = [...GROUP1, ...GROUP2, ...GROUP3];
+
+test("kMeans: three separated groups cluster correctly (labels may permute)", () => {
+  const clusters = kMeans(SEPARATED, 3, { maxIter: 100 });
+  assert.equal(clusters.length, 3);
+  // Content-based check: each cluster must fit exactly one expected group.
+  const expectedGroups = [[0, 1, 2, 3], [4, 5, 6, 7], [8, 9, 10, 11]];
+  for (const c of clusters) {
+    assert.ok(c.length >= 1);
+    const fits = expectedGroups.filter((g) => c.every((idx) => g.includes(idx)));
+    assert.equal(fits.length, 1, `cluster ${JSON.stringify(c)} spans multiple groups`);
+  }
+  // Every index assigned exactly once.
+  assert.deepEqual(clusters.flat().sort((a, b) => a - b), [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]);
+});
+
+test("kMeans: k >= n returns a single cluster of all indices", () => {
+  assert.deepEqual(kMeans(SEPARATED, 12), [[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]]);
+  assert.deepEqual(kMeans(SEPARATED, 0), [[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11]]);
+});
+
+test("kMeans: empty input => no clusters", () => {
+  assert.deepEqual(kMeans([], 3), []);
+});
+
+test("kMeans: empty clusters get reseeded and still terminate", () => {
+  // Many points near two poles with k=3 forces one cluster empty on seed.
+  const vectors = [
+    ...Array.from({ length: 30 }, () => [0, 0]),
+    ...Array.from({ length: 30 }, () => [1, 1])
+  ];
+  const clusters = kMeans(vectors, 3, { maxIter: 50 });
+  assert.equal(clusters.length, 3);
+  assert.equal(clusters.flat().length, vectors.length);
+});
+
+test("clusterMemories: preserves object references and group count", () => {
+  const memories = SEPARATED.map((v, i) => ({ id: `m${i}`, type: "project", title: `t${i}` }));
+  const groups = clusterMemories(memories, SEPARATED, 3);
+  assert.equal(groups.length, 3);
+  assert.equal(groups.flat().length, memories.length);
+  // Reference identity preserved: every group member is an object from input.
+  const all = groups.flat();
+  for (const m of all) assert.ok(memories.includes(m), "cluster contains a foreign object");
+  // Full coverage: each source object appears exactly once across groups.
+  assert.equal(new Set(all).size, memories.length);
+  assert.equal(groups.flat().find((m) => m.id === "m5"), memories[5]);
+});
+
+test("findPotentialConflicts: only same-type highly-similar pairs reported", () => {
+  const memories = [
+    { id: "a", type: "preference", content: "like cold coffee" },
+    { id: "b", type: "preference", content: "hate cold coffee" },
+    { id: "c", type: "project", content: "ship the plugin" }
+  ];
+  const vectors = [
+    [1, 0, 0],
+    [0.99, 0.02, 0],   // nearly parallel to a, same type => conflict
+    [0, 1, 0]          // different type, ignored even if near
+  ];
+  const pairs = findPotentialConflicts(memories, vectors, 0.85);
+  assert.equal(pairs.length, 1);
+  assert.equal(pairs[0].a, memories[0]);
+  assert.equal(pairs[0].b, memories[1]);
+  assert.ok(pairs[0].similarity > 0.85);
+});
+
+test("findPotentialConflicts: below threshold or different type => no pairs", () => {
+  const memories = [
+    { id: "x", type: "preference" },
+    { id: "y", type: "project" }
+  ];
+  assert.deepEqual(findPotentialConflicts(memories, [[1, 0], [0, 1]]), []);
+  assert.deepEqual(findPotentialConflicts(memories, [[1, 0], [0.9, 0.1]], 0.95), []);
+});

package/test/commands.test.js

@@ -1,106 +1,106 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import { createStore } from "../src/store.js";
-import { createSettings } from "../src/settings.js";
-import { createCommandManager } from "../src/commands.js";
-
-function setup() {
-  const store = createStore(":memory:");
-  const settings = createSettings(store.db);
-  const registered = new Map(); // name -> definition
-  const ctx = {
-    commands: {
-      register(def) {
-        registered.set(def.name, def);
-        return () => registered.delete(def.name);
-      }
-    }
-  };
-  const manager = createCommandManager({ ctx, settings, logger: null });
-  return { store, settings, manager, registered };
-}
-
-test("sync registers all stored commands", () => {
-  const { store, settings, manager, registered } = setup();
-  settings.addCommand({ name: "agenda", description: "d", instruction: "列议程" });
-  settings.addCommand({ name: "banner", instruction: "打印横幅" });
-  manager.sync();
-  assert.equal(registered.size, 2);
-  assert.ok(registered.has("agenda") && registered.has("banner"));
-  store.close();
-});
-
-test("add registers live; remove unregisters live", () => {
-  const { store, manager, registered } = setup();
-  const cmd = manager.add({ name: "review", description: "r", instruction: "审查代码" });
-  assert.ok(registered.has("review"), "registered after add");
-  assert.equal(registered.get("review").description, "r");
-  assert.equal(manager.remove(cmd.id), true);
-  assert.ok(!registered.has("review"), "unregistered after remove");
-  store.close();
-});
-
-test("handler submits the instruction to the agent and returns a receipt", async () => {
-  const { store, manager, registered } = setup();
-  manager.add({ name: "fmt", description: "格式化", instruction: "请按项目的 lint 规则格式化当前文件" });
-  const def = registered.get("fmt");
-  assert.ok(def, "definition registered");
-  assert.equal(def.input.hint, "可选：追加给模型的补充说明");
-  const submitted = [];
-  const agent = { followup: (message) => submitted.push(message) };
-  const result = await def.handler({ agent, rawInput: "", signal: null });
-  assert.equal(result.kind, "success");
-  assert.equal(result.text, "已提交指令：fmt");
-  assert.equal(submitted.length, 1);
-  assert.equal(submitted[0].role, "user");
-  assert.deepEqual(submitted[0].content, [{ type: "text", text: "请按项目的 lint 规则格式化当前文件" }]);
-  assert.deepEqual(submitted[0].source, { kind: "user" });
-  store.close();
-});
-
-test("rawInput suffix is appended for the model", async () => {
-  const { store, manager, registered } = setup();
-  manager.add({ name: "mneme", instruction: "以「小墨」的口吻自我介绍" });
-  const def = registered.get("mneme");
-  const submitted = [];
-  await def.handler({ agent: { followup: (m) => submitted.push(m) }, rawInput: "  顺便列出归档数量  " });
-  assert.equal(submitted[0].content[0].text, "以「小墨」的口吻自我介绍\n\n顺便列出归档数量");
-  store.close();
-});
-
-test("handler without a receiving agent falls back to surfacing the instruction", () => {
-  const { store, manager, registered } = setup();
-  manager.add({ name: "fmt", instruction: "legacy text" });
-  const def = registered.get("fmt");
-  const result = def.handler({ rawInput: "" });
-  assert.equal(result.kind, "success");
-  assert.equal(result.text, "legacy text");
-  store.close();
-});
-
-test("handler returns an error result when the agent rejects the submission", () => {
-  const { store, manager, registered } = setup();
-  manager.add({ name: "boom", instruction: "x" });
-  const def = registered.get("boom");
-  const result = def.handler({ agent: { followup: () => { throw new Error("nope"); } } });
-  assert.equal(result.kind, "error");
-  assert.match(result.text, /boom/);
-  store.close();
-});
-
-test("remove of missing id returns false", () => {
-  const { store, manager } = setup();
-  assert.equal(manager.remove("nope"), false);
-  store.close();
-});
-
-test("dispose unregisters everything", () => {
-  const { store, settings, manager, registered } = setup();
-  settings.addCommand({ name: "a", instruction: "x" });
-  settings.addCommand({ name: "b", instruction: "y" });
-  manager.sync();
-  assert.equal(registered.size, 2);
-  manager.dispose();
-  assert.equal(registered.size, 0);
-  store.close();
-});
+import test from "node:test";
+import assert from "node:assert/strict";
+import { createStore } from "../src/store.js";
+import { createSettings } from "../src/settings.js";
+import { createCommandManager } from "../src/commands.js";
+
+function setup() {
+  const store = createStore(":memory:");
+  const settings = createSettings(store.db);
+  const registered = new Map(); // name -> definition
+  const ctx = {
+    commands: {
+      register(def) {
+        registered.set(def.name, def);
+        return () => registered.delete(def.name);
+      }
+    }
+  };
+  const manager = createCommandManager({ ctx, settings, logger: null });
+  return { store, settings, manager, registered };
+}
+
+test("sync registers all stored commands", () => {
+  const { store, settings, manager, registered } = setup();
+  settings.addCommand({ name: "agenda", description: "d", instruction: "列议程" });
+  settings.addCommand({ name: "banner", instruction: "打印横幅" });
+  manager.sync();
+  assert.equal(registered.size, 2);
+  assert.ok(registered.has("agenda") && registered.has("banner"));
+  store.close();
+});
+
+test("add registers live; remove unregisters live", () => {
+  const { store, manager, registered } = setup();
+  const cmd = manager.add({ name: "review", description: "r", instruction: "审查代码" });
+  assert.ok(registered.has("review"), "registered after add");
+  assert.equal(registered.get("review").description, "r");
+  assert.equal(manager.remove(cmd.id), true);
+  assert.ok(!registered.has("review"), "unregistered after remove");
+  store.close();
+});
+
+test("handler submits the instruction to the agent and returns a receipt", async () => {
+  const { store, manager, registered } = setup();
+  manager.add({ name: "fmt", description: "格式化", instruction: "请按项目的 lint 规则格式化当前文件" });
+  const def = registered.get("fmt");
+  assert.ok(def, "definition registered");
+  assert.equal(def.input.hint, "可选：追加给模型的补充说明");
+  const submitted = [];
+  const agent = { followup: (message) => submitted.push(message) };
+  const result = await def.handler({ agent, rawInput: "", signal: null });
+  assert.equal(result.kind, "success");
+  assert.equal(result.text, "已提交指令：fmt");
+  assert.equal(submitted.length, 1);
+  assert.equal(submitted[0].role, "user");
+  assert.deepEqual(submitted[0].content, [{ type: "text", text: "请按项目的 lint 规则格式化当前文件" }]);
+  assert.deepEqual(submitted[0].source, { kind: "user" });
+  store.close();
+});
+
+test("rawInput suffix is appended for the model", async () => {
+  const { store, manager, registered } = setup();
+  manager.add({ name: "mneme", instruction: "以「小墨」的口吻自我介绍" });
+  const def = registered.get("mneme");
+  const submitted = [];
+  await def.handler({ agent: { followup: (m) => submitted.push(m) }, rawInput: "  顺便列出归档数量  " });
+  assert.equal(submitted[0].content[0].text, "以「小墨」的口吻自我介绍\n\n顺便列出归档数量");
+  store.close();
+});
+
+test("handler without a receiving agent falls back to surfacing the instruction", () => {
+  const { store, manager, registered } = setup();
+  manager.add({ name: "fmt", instruction: "legacy text" });
+  const def = registered.get("fmt");
+  const result = def.handler({ rawInput: "" });
+  assert.equal(result.kind, "success");
+  assert.equal(result.text, "legacy text");
+  store.close();
+});
+
+test("handler returns an error result when the agent rejects the submission", () => {
+  const { store, manager, registered } = setup();
+  manager.add({ name: "boom", instruction: "x" });
+  const def = registered.get("boom");
+  const result = def.handler({ agent: { followup: () => { throw new Error("nope"); } } });
+  assert.equal(result.kind, "error");
+  assert.match(result.text, /boom/);
+  store.close();
+});
+
+test("remove of missing id returns false", () => {
+  const { store, manager } = setup();
+  assert.equal(manager.remove("nope"), false);
+  store.close();
+});
+
+test("dispose unregisters everything", () => {
+  const { store, settings, manager, registered } = setup();
+  settings.addCommand({ name: "a", instruction: "x" });
+  settings.addCommand({ name: "b", instruction: "y" });
+  manager.sync();
+  assert.equal(registered.size, 2);
+  manager.dispose();
+  assert.equal(registered.size, 0);
+  store.close();
+});

package/test/config.test.js

@@ -1,66 +1,66 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import { readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { Config } from "../src/config.js";
-
-// ---------------------------------------------------------------- rerank opt-in (item ⑥)
-
-test("rerank is opt-in: default config does not enable the local reranker", () => {
-  const cfg = Config({});
-  assert.equal(cfg.rerankEnabled, false, "rerankEnabled defaults to false");
-  assert.equal(cfg.rerankProvider, "none", "rerankProvider defaults to none");
-  // The plugin gate in index.js: LocalReranker is only constructed when both
-  // hold — under defaults the gate is closed, so onnxruntime is never loaded.
-  assert.equal(cfg.rerankEnabled && cfg.rerankProvider === "local", false, "gate closed by default");
-  const enabled = Config({ rerankEnabled: true, rerankProvider: "local" });
-  assert.equal(enabled.rerankEnabled && enabled.rerankProvider === "local", true, "explicit opt-in opens the gate");
-});
-
-test("dream sliding window + implicit keep config defaults and bounds (v0.4.4)", () => {
-  const cfg = Config({});
-  assert.equal(cfg.dreamMaxSnapshotSize, 200, "window defaults to 200");
-  assert.equal(cfg.dreamImplicitKeep, true, "implicit keep defaults to true");
-  const capped = Config({ dreamMaxSnapshotSize: 1000 });
-  assert.equal(capped.dreamMaxSnapshotSize, 1000, "upper bound accepted");
-  const off = Config({ dreamImplicitKeep: false });
-  assert.equal(off.dreamImplicitKeep, false, "implicit keep can be disabled");
-});
-
-test("dream explicit coverage threshold config defaults and bounds (v0.4.4 fix)", () => {
-  const cfg = Config({});
-  assert.equal(cfg.dreamMinExplicitCoverage, 0.5, "coverage threshold defaults to 0.5");
-  const low = Config({ dreamMinExplicitCoverage: 0.1 });
-  assert.equal(low.dreamMinExplicitCoverage, 0.1, "lower bound accepted");
-  const high = Config({ dreamMinExplicitCoverage: 1 });
-  assert.equal(high.dreamMinExplicitCoverage, 1, "upper bound accepted");
-});
-
-test("startup probe: the reranker module never statically imports transformers/onnxruntime", () => {
-  // LocalReranker is imported eagerly by index.js, so a bare install must not
-  // pull onnxruntime in at module load. The heavy load is a lazy dynamic import
-  // that only runs inside init(), which index.js calls only when the opt-in gate
-  // is open (rerankEnabled && rerankProvider === "local").
-  const src = readFileSync(new URL("../src/reranker.js", import.meta.url), "utf8");
-  assert.ok(
-    !src.includes('from "@huggingface/transformers"'),
-    "no static transformers.js import in reranker.js"
-  );
-  // issue #131 之后，懒加载的落点从 reranker 内部搬到了 src/runtime/loader.js
-  // （三层解析：自管 payload → 宿主裸 specifier）。判据随之改成两条，意图不变：
-  // reranker 不得静态导入，且必须经由 loader 间接加载；动态 import 只允许出现在
-  // loader 里（它是唯一知道「运行时从哪来」的模块）。
-  assert.match(src, /from "\.\/runtime\/loader\.js"/, "reranker 经 runtime/loader.js 取运行时");
-  assert.match(src, /loadTransformers\(/, "reranker 必须走三层解析，而不是自己拼 import");
-  assert.ok(
-    !/^\s*import[^\n]*@huggingface\/transformers/m.test(src),
-    "reranker 不允许任何形式的静态 transformers 导入"
-  );
-
-  const loaderSrc = readFileSync(new URL("../src/runtime/loader.js", import.meta.url), "utf8");
-  assert.match(loaderSrc, /import\(specifier\)/, "loader 用动态 import 保持懒加载");
-  assert.ok(
-    !/^\s*import[^\n]*@huggingface\/transformers/m.test(loaderSrc),
-    "loader 不得静态导入 transformers，否则惰性加载就失效了"
-  );
-});
+import test from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { Config } from "../src/config.js";
+
+// ---------------------------------------------------------------- rerank opt-in (item ⑥)
+
+test("rerank is opt-in: default config does not enable the local reranker", () => {
+  const cfg = Config({});
+  assert.equal(cfg.rerankEnabled, false, "rerankEnabled defaults to false");
+  assert.equal(cfg.rerankProvider, "none", "rerankProvider defaults to none");
+  // The plugin gate in index.js: LocalReranker is only constructed when both
+  // hold — under defaults the gate is closed, so onnxruntime is never loaded.
+  assert.equal(cfg.rerankEnabled && cfg.rerankProvider === "local", false, "gate closed by default");
+  const enabled = Config({ rerankEnabled: true, rerankProvider: "local" });
+  assert.equal(enabled.rerankEnabled && enabled.rerankProvider === "local", true, "explicit opt-in opens the gate");
+});
+
+test("dream sliding window + implicit keep config defaults and bounds (v0.4.4)", () => {
+  const cfg = Config({});
+  assert.equal(cfg.dreamMaxSnapshotSize, 200, "window defaults to 200");
+  assert.equal(cfg.dreamImplicitKeep, true, "implicit keep defaults to true");
+  const capped = Config({ dreamMaxSnapshotSize: 1000 });
+  assert.equal(capped.dreamMaxSnapshotSize, 1000, "upper bound accepted");
+  const off = Config({ dreamImplicitKeep: false });
+  assert.equal(off.dreamImplicitKeep, false, "implicit keep can be disabled");
+});
+
+test("dream explicit coverage threshold config defaults and bounds (v0.4.4 fix)", () => {
+  const cfg = Config({});
+  assert.equal(cfg.dreamMinExplicitCoverage, 0.5, "coverage threshold defaults to 0.5");
+  const low = Config({ dreamMinExplicitCoverage: 0.1 });
+  assert.equal(low.dreamMinExplicitCoverage, 0.1, "lower bound accepted");
+  const high = Config({ dreamMinExplicitCoverage: 1 });
+  assert.equal(high.dreamMinExplicitCoverage, 1, "upper bound accepted");
+});
+
+test("startup probe: the reranker module never statically imports transformers/onnxruntime", () => {
+  // LocalReranker is imported eagerly by index.js, so a bare install must not
+  // pull onnxruntime in at module load. The heavy load is a lazy dynamic import
+  // that only runs inside init(), which index.js calls only when the opt-in gate
+  // is open (rerankEnabled && rerankProvider === "local").
+  const src = readFileSync(new URL("../src/reranker.js", import.meta.url), "utf8");
+  assert.ok(
+    !src.includes('from "@huggingface/transformers"'),
+    "no static transformers.js import in reranker.js"
+  );
+  // issue #131 之后，懒加载的落点从 reranker 内部搬到了 src/runtime/loader.js
+  // （三层解析：自管 payload → 宿主裸 specifier）。判据随之改成两条，意图不变：
+  // reranker 不得静态导入，且必须经由 loader 间接加载；动态 import 只允许出现在
+  // loader 里（它是唯一知道「运行时从哪来」的模块）。
+  assert.match(src, /from "\.\/runtime\/loader\.js"/, "reranker 经 runtime/loader.js 取运行时");
+  assert.match(src, /loadTransformers\(/, "reranker 必须走三层解析，而不是自己拼 import");
+  assert.ok(
+    !/^\s*import[^\n]*@huggingface\/transformers/m.test(src),
+    "reranker 不允许任何形式的静态 transformers 导入"
+  );
+
+  const loaderSrc = readFileSync(new URL("../src/runtime/loader.js", import.meta.url), "utf8");
+  assert.match(loaderSrc, /import\(specifier\)/, "loader 用动态 import 保持懒加载");
+  assert.ok(
+    !/^\s*import[^\n]*@huggingface\/transformers/m.test(loaderSrc),
+    "loader 不得静态导入 transformers，否则惰性加载就失效了"
+  );
+});