@modusensus/dsh-mneme 0.13.0 → 0.14.0-beta.2

package/test/failure-query.test.js

@@ -1,147 +1,147 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import { createStore } from "../src/store.js";
-import { createService } from "../src/service.js";
-import { createTools } from "../src/tools.js";
-
-// v0.9.0：failure_memories.query 的起点是 2,367 行里只有 69 行非空（2.9%）。
-// 但那个分母误导——按「expected 逐字落在某次 dream_runs.decisions 里」归属后
-// （2026-10-14 实测，D:/DSH/.dsh/memory/memory.db）：
-//   dream 侧 2,118 行，query 非空率 0.0%——机器巩固没有用户在场，本该为空；
-//   入口侧   249 行，query 非空率 27.7%——模型自愿填 reason 的那部分。
-// 所以要修的是入口侧，不是 dream 侧。
-//
-// 修法：工具层是唯一同时握着「改写动作」与「本轮会话」的入口（service 层只认
-// ctx.query，见 src/service.js updateMemory 内的 saveFailure 调用）。调用方没给
-// reason 时，工具自己去会话里取当轮用户原话——与注入侧共用同一份实现
-// （src/inject.js 的 lastUserQuery），不复制第二份。
-//
-// 本文件锁三件事：① 没给 reason 时真的落到原话；② 给了 reason 不被覆盖；
-// ③ 两边都取不到时写 NULL 而不是空串——空串会假装「有意图」，NULL 才说实话。
-
-function setup(config = {}) {
-  const store = createStore(":memory:");
-  const service = createService({
-    store,
-    mirror: null,
-    config: { reflectionFailureTracking: true, ...config }
-  });
-  const registered = [];
-  const ctx = { tools: { register(def) { registered.push(def); return () => {}; } } };
-  createTools(ctx, service, config, null);
-  const tool = (name) => registered.find((def) => def.name === name);
-  return { store, service, tool };
-}
-
-const seed = (store) => store.save({ type: "preference", title: "语言", content: "喜欢 Python", importance: 3 });
-
-/** exec 形状与宿主一致：工具 execute 的第二个参数（src/tools.js 里的 arguments[1]）。 */
-const execWith = (events, extra = {}) => ({
-  agent: { session: { id: "s-failure-query", snapshotEvents: () => events, ...extra } }
-});
-
-const userMessage = (text, seq) => ({
-  type: "user/message",
-  ...(seq === undefined ? {} : { seq }),
-  data: { source: { kind: "user" }, content: [{ type: "text", text }] }
-});
-
-const assistantMessage = (text, seq) => ({
-  type: "assistant/message",
-  ...(seq === undefined ? {} : { seq }),
-  data: { message: { content: [{ type: "text", text }] } }
-});
-
-const run = (def, args, exec) => def.execute.bind(def)(args, exec);
-
-test("memory_update 没给 reason 时，query 落当轮用户原话", async () => {
-  const { store, tool } = setup();
-  const mem = seed(store);
-  await run(
-    tool("memory_update"),
-    { id: mem.id, content: "喜欢 Rust" },
-    execWith([userMessage("不对，我喜欢的是 Rust，不是 Python")])
-  );
-  const [row] = store.listFailures();
-  assert.equal(row.query, "不对，我喜欢的是 Rust，不是 Python");
-  // expected/actual 语义未变：expected = 改成了什么，actual = 原本是什么。
-  assert.equal(row.expected, "喜欢 Rust");
-  assert.equal(row.actual, "喜欢 Python");
-  assert.equal(row.failure_type, "user_correction");
-  assert.equal(row.memory_id, mem.id);
-});
-
-test("memory_update 给了 reason 就用 reason，不被会话原话顶掉", async () => {
-  const { store, tool } = setup();
-  const mem = seed(store);
-  await run(
-    tool("memory_update"),
-    { id: mem.id, content: "喜欢 Rust", reason: "用户说：换成 Rust" },
-    execWith([userMessage("这句是当轮原话，但调用方已经说清了理由")])
-  );
-  assert.equal(store.listFailures()[0].query, "用户说：换成 Rust");
-});
-
-test("reason 是空白串时按「没给」处理，退回会话原话", async () => {
-  const { store, tool } = setup();
-  const mem = seed(store);
-  // 与 api-standalone 的 PUT /memories/:id 同口径（body.reason.trim() 为空即视作未提供）。
-  await run(
-    tool("memory_update"),
-    { id: mem.id, content: "喜欢 Rust", reason: "   " },
-    execWith([userMessage("换成 Rust 吧")])
-  );
-  assert.equal(store.listFailures()[0].query, "换成 Rust 吧");
-});
-
-test("两边都取不到时写 NULL，不写空串（空串会假装有意图）", async () => {
-  const { store, tool } = setup();
-  const mem = seed(store);
-  // 会话里只有助手消息 → 取不到「用户原话」。
-  await run(tool("memory_update"), { id: mem.id, content: "喜欢 Rust" }, execWith([assistantMessage("好的")]));
-  assert.equal(store.listFailures()[0].query, null);
-
-  // 完全没有 exec（老宿主 / 直调）→ 同样 NULL，不抛。
-  const mem2 = store.save({ type: "preference", title: "编辑器", content: "vim", importance: 3 });
-  await run(tool("memory_update"), { id: mem2.id, content: "emacs" });
-  assert.equal(store.listFailures()[1].query, null);
-});
-
-test("被撤回/压缩遮蔽的用户消息不算当轮原话（复用注入侧同一份实现）", async () => {
-  const { store, tool } = setup();
-  const mem = seed(store);
-  // seq 1 被 rewind 遮蔽（surface.nodes 只暴露 2）——同 inject.js visibleSeqsOf 口径。
-  // 这条同时锁住「没有抄第二份实现」：naive 的副本会漏掉可见面过滤。
-  const events = [userMessage("我想撤回的那句话", 1), assistantMessage("好", 2)];
-  await run(
-    tool("memory_update"),
-    { id: mem.id, content: "喜欢 Rust" },
-    execWith(events, { surface: { nodes: [2] } })
-  );
-  assert.equal(store.listFailures()[0].query, null, "被遮蔽的消息不许当成原话");
-});
-
-test("会话内部读不出来时退化为 NULL，不让改写本身失败", async () => {
-  const { store, tool } = setup();
-  const mem = seed(store);
-  // 宿主 getter 抛错（cordis Proxy 裸读未 inject 属性）——lastUserQuery 的 catch 兜住。
-  const exec = {
-    agent: {
-      get session() {
-        throw new Error("not injected");
-      }
-    }
-  };
-  await run(tool("memory_update"), { id: mem.id, content: "喜欢 Rust" }, exec);
-  const [row] = store.listFailures();
-  assert.equal(row.query, null);
-  assert.equal(row.expected, "喜欢 Rust", "改写本身照常完成");
-  assert.equal(store.getById(mem.id).content, "喜欢 Rust");
-});
-
-test("过长的原话按注入侧同一上限截断（不是各截各的）", async () => {
-  const { store, tool } = setup();
-  const mem = seed(store);
-  await run(tool("memory_update"), { id: mem.id, content: "喜欢 Rust" }, execWith([userMessage("长".repeat(900))]));
-  assert.equal(store.listFailures()[0].query.length, 500, "safeSlice(…, 500) 与注入侧一致");
-});
+import test from "node:test";
+import assert from "node:assert/strict";
+import { createStore } from "../src/store.js";
+import { createService } from "../src/service.js";
+import { createTools } from "../src/tools.js";
+
+// v0.9.0：failure_memories.query 的起点是 2,367 行里只有 69 行非空（2.9%）。
+// 但那个分母误导——按「expected 逐字落在某次 dream_runs.decisions 里」归属后
+// （2026-10-14 实测，D:/DSH/.dsh/memory/memory.db）：
+//   dream 侧 2,118 行，query 非空率 0.0%——机器巩固没有用户在场，本该为空；
+//   入口侧   249 行，query 非空率 27.7%——模型自愿填 reason 的那部分。
+// 所以要修的是入口侧，不是 dream 侧。
+//
+// 修法：工具层是唯一同时握着「改写动作」与「本轮会话」的入口（service 层只认
+// ctx.query，见 src/service.js updateMemory 内的 saveFailure 调用）。调用方没给
+// reason 时，工具自己去会话里取当轮用户原话——与注入侧共用同一份实现
+// （src/inject.js 的 lastUserQuery），不复制第二份。
+//
+// 本文件锁三件事：① 没给 reason 时真的落到原话；② 给了 reason 不被覆盖；
+// ③ 两边都取不到时写 NULL 而不是空串——空串会假装「有意图」，NULL 才说实话。
+
+function setup(config = {}) {
+  const store = createStore(":memory:");
+  const service = createService({
+    store,
+    mirror: null,
+    config: { reflectionFailureTracking: true, ...config }
+  });
+  const registered = [];
+  const ctx = { tools: { register(def) { registered.push(def); return () => {}; } } };
+  createTools(ctx, service, config, null);
+  const tool = (name) => registered.find((def) => def.name === name);
+  return { store, service, tool };
+}
+
+const seed = (store) => store.save({ type: "preference", title: "语言", content: "喜欢 Python", importance: 3 });
+
+/** exec 形状与宿主一致：工具 execute 的第二个参数（src/tools.js 里的 arguments[1]）。 */
+const execWith = (events, extra = {}) => ({
+  agent: { session: { id: "s-failure-query", snapshotEvents: () => events, ...extra } }
+});
+
+const userMessage = (text, seq) => ({
+  type: "user/message",
+  ...(seq === undefined ? {} : { seq }),
+  data: { source: { kind: "user" }, content: [{ type: "text", text }] }
+});
+
+const assistantMessage = (text, seq) => ({
+  type: "assistant/message",
+  ...(seq === undefined ? {} : { seq }),
+  data: { message: { content: [{ type: "text", text }] } }
+});
+
+const run = (def, args, exec) => def.execute.bind(def)(args, exec);
+
+test("memory_update 没给 reason 时，query 落当轮用户原话", async () => {
+  const { store, tool } = setup();
+  const mem = seed(store);
+  await run(
+    tool("memory_update"),
+    { id: mem.id, content: "喜欢 Rust" },
+    execWith([userMessage("不对，我喜欢的是 Rust，不是 Python")])
+  );
+  const [row] = store.listFailures();
+  assert.equal(row.query, "不对，我喜欢的是 Rust，不是 Python");
+  // expected/actual 语义未变：expected = 改成了什么，actual = 原本是什么。
+  assert.equal(row.expected, "喜欢 Rust");
+  assert.equal(row.actual, "喜欢 Python");
+  assert.equal(row.failure_type, "user_correction");
+  assert.equal(row.memory_id, mem.id);
+});
+
+test("memory_update 给了 reason 就用 reason，不被会话原话顶掉", async () => {
+  const { store, tool } = setup();
+  const mem = seed(store);
+  await run(
+    tool("memory_update"),
+    { id: mem.id, content: "喜欢 Rust", reason: "用户说：换成 Rust" },
+    execWith([userMessage("这句是当轮原话，但调用方已经说清了理由")])
+  );
+  assert.equal(store.listFailures()[0].query, "用户说：换成 Rust");
+});
+
+test("reason 是空白串时按「没给」处理，退回会话原话", async () => {
+  const { store, tool } = setup();
+  const mem = seed(store);
+  // 与 api-standalone 的 PUT /memories/:id 同口径（body.reason.trim() 为空即视作未提供）。
+  await run(
+    tool("memory_update"),
+    { id: mem.id, content: "喜欢 Rust", reason: "   " },
+    execWith([userMessage("换成 Rust 吧")])
+  );
+  assert.equal(store.listFailures()[0].query, "换成 Rust 吧");
+});
+
+test("两边都取不到时写 NULL，不写空串（空串会假装有意图）", async () => {
+  const { store, tool } = setup();
+  const mem = seed(store);
+  // 会话里只有助手消息 → 取不到「用户原话」。
+  await run(tool("memory_update"), { id: mem.id, content: "喜欢 Rust" }, execWith([assistantMessage("好的")]));
+  assert.equal(store.listFailures()[0].query, null);
+
+  // 完全没有 exec（老宿主 / 直调）→ 同样 NULL，不抛。
+  const mem2 = store.save({ type: "preference", title: "编辑器", content: "vim", importance: 3 });
+  await run(tool("memory_update"), { id: mem2.id, content: "emacs" });
+  assert.equal(store.listFailures()[1].query, null);
+});
+
+test("被撤回/压缩遮蔽的用户消息不算当轮原话（复用注入侧同一份实现）", async () => {
+  const { store, tool } = setup();
+  const mem = seed(store);
+  // seq 1 被 rewind 遮蔽（surface.nodes 只暴露 2）——同 inject.js visibleSeqsOf 口径。
+  // 这条同时锁住「没有抄第二份实现」：naive 的副本会漏掉可见面过滤。
+  const events = [userMessage("我想撤回的那句话", 1), assistantMessage("好", 2)];
+  await run(
+    tool("memory_update"),
+    { id: mem.id, content: "喜欢 Rust" },
+    execWith(events, { surface: { nodes: [2] } })
+  );
+  assert.equal(store.listFailures()[0].query, null, "被遮蔽的消息不许当成原话");
+});
+
+test("会话内部读不出来时退化为 NULL，不让改写本身失败", async () => {
+  const { store, tool } = setup();
+  const mem = seed(store);
+  // 宿主 getter 抛错（cordis Proxy 裸读未 inject 属性）——lastUserQuery 的 catch 兜住。
+  const exec = {
+    agent: {
+      get session() {
+        throw new Error("not injected");
+      }
+    }
+  };
+  await run(tool("memory_update"), { id: mem.id, content: "喜欢 Rust" }, exec);
+  const [row] = store.listFailures();
+  assert.equal(row.query, null);
+  assert.equal(row.expected, "喜欢 Rust", "改写本身照常完成");
+  assert.equal(store.getById(mem.id).content, "喜欢 Rust");
+});
+
+test("过长的原话按注入侧同一上限截断（不是各截各的）", async () => {
+  const { store, tool } = setup();
+  const mem = seed(store);
+  await run(tool("memory_update"), { id: mem.id, content: "喜欢 Rust" }, execWith([userMessage("长".repeat(900))]));
+  assert.equal(store.listFailures()[0].query.length, 500, "safeSlice(…, 500) 与注入侧一致");
+});

package/test/failure-retention.test.js

@@ -1,105 +1,105 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import { readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { Config } from "../src/config.js";
-import { createStore } from "../src/store.js";
-
-// 与 test/recall-retention.test.js 同款，这组测试故意分两半，因为弄丢的正是「两半
-// 都在」：
-// 1. 行为锁——deleteOldFailures 真的删对行、比较方向正确、空表不炸。
-// 2. 接线锁——src/index.js 的启动块真的调它，且读的是装配后的 cfg。第二半用源码
-//    文本断言，理由与 test/client.test.js 的 bilingual 锁同款：启动期清理只在运维
-//    时才会跑到，运行时冒烟测不到「这一行被挪回装配之前了」。
-//
-// 这一批补的是「写死」这条欠账：failure_memories 的清理此前排在 createStore 之后、
-// cfg 装配之前，天数硬编码 90，是四张启动期清理表里唯一没有键可陈述的一张。
-
-const here = dirname(fileURLToPath(import.meta.url));
-const srcText = (name) => readFileSync(join(here, "..", "src", name), "utf8");
-const daysAgo = (n) => new Date(Date.now() - n * 86400000).toISOString();
-
-// saveFailure 只认当前时刻，所以插进去之后把 created_at 改写成指定时刻。
-function seedFailure(store, createdAt, id) {
-  store.saveFailure({ id, failure_type: "user_correction", expected: "新值", actual: "旧值" });
-  store.db.prepare("UPDATE failure_memories SET created_at = ? WHERE id = ?").run(createdAt, id);
-  return id;
-}
-
-test("deleteOldFailures 删掉窗口外的行、留下窗口内的行", () => {
-  const store = createStore(":memory:");
-  seedFailure(store, daysAgo(200), "old-1");
-  seedFailure(store, daysAgo(120), "old-2");
-  seedFailure(store, daysAgo(10), "fresh-1");
-  seedFailure(store, daysAgo(1), "fresh-2");
-
-  assert.equal(store.listFailures().length, 4);
-  const removed = store.deleteOldFailures(daysAgo(90));
-  assert.equal(removed, 2);
-  // assert 的是留下了哪两行，不是物理顺序
-  assert.deepEqual(store.listFailures().map((r) => r.id).sort(), ["fresh-1", "fresh-2"]);
-});
-
-test("边界两侧各留 1 小时裕量：锁的是比较方向不是毫秒级巧合", () => {
-  const store = createStore(":memory:");
-  const boundary = 90 * 86400000;
-  // cutoff 是在清理那一刻现算的，所以不骑刀刃——两侧各让开一小时。
-  seedFailure(store, new Date(Date.now() - boundary + 3600000).toISOString(), "just-inside");
-  seedFailure(store, new Date(Date.now() - boundary - 3600000).toISOString(), "just-outside");
-
-  const removed = store.deleteOldFailures(new Date(Date.now() - boundary).toISOString());
-  assert.equal(removed, 1, "只有 created_at < cutoff 的那一行该走");
-  assert.deepEqual(store.listFailures().map((r) => r.id), ["just-inside"]);
-});
-
-test("空表返回 0 且不抛", () => {
-  const store = createStore(":memory:");
-  assert.equal(store.deleteOldFailures(daysAgo(90)), 0);
-});
-
-test("配置键 reflectionFailureRetentionDays：默认 90、单位是天、边界钉死", () => {
-  assert.equal(Config({}).reflectionFailureRetentionDays, 90, "默认值必须与旧行为一致");
-  assert.equal(Config({ reflectionFailureRetentionDays: 30 }).reflectionFailureRetentionDays, 30);
-  assert.equal(Config({ reflectionFailureRetentionDays: 3650 }).reflectionFailureRetentionDays, 3650);
-  // 0 天会把这张表压成「只留最近一次」，等于废掉「挖掘重复纠正模式」的用途
-  assert.throws(() => Config({ reflectionFailureRetentionDays: 0 }));
-  assert.throws(() => Config({ reflectionFailureRetentionDays: 3651 }));
-  assert.throws(() => Config({ reflectionFailureRetentionDays: 2.5 }));
-
-  // 形状锁：与 recallRetentionDays 一族同形，别各自演化
-  assert.match(
-    srcText("config.js"),
-    /reflectionFailureRetentionDays: z\.natural\(\)\.min\(1\)\.max\(3650\)\.default\(90\)/
-  );
-  // 文档面同步：README 的键表与 docs/CONFIGURATION.md 的键表是用户唯一能读到
-  // 这个键的地方。用布尔断言而不是 assert.match——断言失败时 node:test 会把整个
-  // 文件正文打进 diff，几百行文档刷满输出，反而看不见失败点。
-  for (const doc of ["README.md", "docs/CONFIGURATION.md"]) {
-    const text = readFileSync(join(here, "..", doc), "utf8");
-    assert.ok(
-      text.includes("`reflectionFailureRetentionDays`"),
-      `${doc} 必须列出 reflectionFailureRetentionDays —— 加了键不改文档正是这一族欠账的来源`
-    );
-  }
-});
-
-test("接线锁：启动期失败表清理排在 cfg 装配之后，读键而不是写死的 90 天", () => {
-  const index = srcText("index.js");
-  const callAt = index.indexOf("store.deleteOldFailures(");
-  assert.ok(callAt > 0, "index.js 必须调用 store.deleteOldFailures");
-
-  // 装配前读 rawCfg 会漏掉面板/预设合进来的值；失败表此前正好排在装配之前。
-  const cfgAt = index.indexOf("const cfg = { ...applyLightModePreset(");
-  assert.ok(cfgAt > 0 && cfgAt < callAt, "清理必须排在 cfg 装配之后，否则读不到配置值");
-
-  const block = index.slice(callAt - 700, callAt + 200);
-  assert.match(block, /cfg\.reflectionFailureRetentionDays/, "天数必须取自配置键");
-  assert.match(block, /Number\.isInteger\(/, "非法值要能落回默认，别让 NaN 传给 SQL");
-  assert.match(block, /failureRetentionDays \* 86400000/, "键的单位是天，换算在这儿");
-
-  assert.ok(
-    !/Date\.now\(\) - 90 \* 86400000/.test(index),
-    "写死的 90 天不能回来——这正是本批在修的那条欠账"
-  );
-});
+import test from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Config } from "../src/config.js";
+import { createStore } from "../src/store.js";
+
+// 与 test/recall-retention.test.js 同款，这组测试故意分两半，因为弄丢的正是「两半
+// 都在」：
+// 1. 行为锁——deleteOldFailures 真的删对行、比较方向正确、空表不炸。
+// 2. 接线锁——src/index.js 的启动块真的调它，且读的是装配后的 cfg。第二半用源码
+//    文本断言，理由与 test/client.test.js 的 bilingual 锁同款：启动期清理只在运维
+//    时才会跑到，运行时冒烟测不到「这一行被挪回装配之前了」。
+//
+// 这一批补的是「写死」这条欠账：failure_memories 的清理此前排在 createStore 之后、
+// cfg 装配之前，天数硬编码 90，是四张启动期清理表里唯一没有键可陈述的一张。
+
+const here = dirname(fileURLToPath(import.meta.url));
+const srcText = (name) => readFileSync(join(here, "..", "src", name), "utf8");
+const daysAgo = (n) => new Date(Date.now() - n * 86400000).toISOString();
+
+// saveFailure 只认当前时刻，所以插进去之后把 created_at 改写成指定时刻。
+function seedFailure(store, createdAt, id) {
+  store.saveFailure({ id, failure_type: "user_correction", expected: "新值", actual: "旧值" });
+  store.db.prepare("UPDATE failure_memories SET created_at = ? WHERE id = ?").run(createdAt, id);
+  return id;
+}
+
+test("deleteOldFailures 删掉窗口外的行、留下窗口内的行", () => {
+  const store = createStore(":memory:");
+  seedFailure(store, daysAgo(200), "old-1");
+  seedFailure(store, daysAgo(120), "old-2");
+  seedFailure(store, daysAgo(10), "fresh-1");
+  seedFailure(store, daysAgo(1), "fresh-2");
+
+  assert.equal(store.listFailures().length, 4);
+  const removed = store.deleteOldFailures(daysAgo(90));
+  assert.equal(removed, 2);
+  // assert 的是留下了哪两行，不是物理顺序
+  assert.deepEqual(store.listFailures().map((r) => r.id).sort(), ["fresh-1", "fresh-2"]);
+});
+
+test("边界两侧各留 1 小时裕量：锁的是比较方向不是毫秒级巧合", () => {
+  const store = createStore(":memory:");
+  const boundary = 90 * 86400000;
+  // cutoff 是在清理那一刻现算的，所以不骑刀刃——两侧各让开一小时。
+  seedFailure(store, new Date(Date.now() - boundary + 3600000).toISOString(), "just-inside");
+  seedFailure(store, new Date(Date.now() - boundary - 3600000).toISOString(), "just-outside");
+
+  const removed = store.deleteOldFailures(new Date(Date.now() - boundary).toISOString());
+  assert.equal(removed, 1, "只有 created_at < cutoff 的那一行该走");
+  assert.deepEqual(store.listFailures().map((r) => r.id), ["just-inside"]);
+});
+
+test("空表返回 0 且不抛", () => {
+  const store = createStore(":memory:");
+  assert.equal(store.deleteOldFailures(daysAgo(90)), 0);
+});
+
+test("配置键 reflectionFailureRetentionDays：默认 90、单位是天、边界钉死", () => {
+  assert.equal(Config({}).reflectionFailureRetentionDays, 90, "默认值必须与旧行为一致");
+  assert.equal(Config({ reflectionFailureRetentionDays: 30 }).reflectionFailureRetentionDays, 30);
+  assert.equal(Config({ reflectionFailureRetentionDays: 3650 }).reflectionFailureRetentionDays, 3650);
+  // 0 天会把这张表压成「只留最近一次」，等于废掉「挖掘重复纠正模式」的用途
+  assert.throws(() => Config({ reflectionFailureRetentionDays: 0 }));
+  assert.throws(() => Config({ reflectionFailureRetentionDays: 3651 }));
+  assert.throws(() => Config({ reflectionFailureRetentionDays: 2.5 }));
+
+  // 形状锁：与 recallRetentionDays 一族同形，别各自演化
+  assert.match(
+    srcText("config.js"),
+    /reflectionFailureRetentionDays: z\.natural\(\)\.min\(1\)\.max\(3650\)\.default\(90\)/
+  );
+  // 文档面同步：README 的键表与 docs/CONFIGURATION.md 的键表是用户唯一能读到
+  // 这个键的地方。用布尔断言而不是 assert.match——断言失败时 node:test 会把整个
+  // 文件正文打进 diff，几百行文档刷满输出，反而看不见失败点。
+  for (const doc of ["README.md", "docs/CONFIGURATION.md"]) {
+    const text = readFileSync(join(here, "..", doc), "utf8");
+    assert.ok(
+      text.includes("`reflectionFailureRetentionDays`"),
+      `${doc} 必须列出 reflectionFailureRetentionDays —— 加了键不改文档正是这一族欠账的来源`
+    );
+  }
+});
+
+test("接线锁：启动期失败表清理排在 cfg 装配之后，读键而不是写死的 90 天", () => {
+  const index = srcText("index.js");
+  const callAt = index.indexOf("store.deleteOldFailures(");
+  assert.ok(callAt > 0, "index.js 必须调用 store.deleteOldFailures");
+
+  // 装配前读 rawCfg 会漏掉面板/预设合进来的值；失败表此前正好排在装配之前。
+  const cfgAt = index.indexOf("const cfg = { ...applyLightModePreset(");
+  assert.ok(cfgAt > 0 && cfgAt < callAt, "清理必须排在 cfg 装配之后，否则读不到配置值");
+
+  const block = index.slice(callAt - 700, callAt + 200);
+  assert.match(block, /cfg\.reflectionFailureRetentionDays/, "天数必须取自配置键");
+  assert.match(block, /Number\.isInteger\(/, "非法值要能落回默认，别让 NaN 传给 SQL");
+  assert.match(block, /failureRetentionDays \* 86400000/, "键的单位是天，换算在这儿");
+
+  assert.ok(
+    !/Date\.now\(\) - 90 \* 86400000/.test(index),
+    "写死的 90 天不能回来——这正是本批在修的那条欠账"
+  );
+});