recallnest 3.0.0 → 4.0.0

package/src/__tests__/cluster-consolidation.test.ts

@@ -1,1236 +0,0 @@
-import { describe, expect, it } from "bun:test";
-
-import {
-  clusterAndConsolidate,
-  deduplicateByClusterInsight,
-  SYNTHESIS_CONTRACT_VERSION,
-  type ClusterConsolidationResult,
-} from "../consolidation-engine.js";
-import { extractBoundaryMetadata } from "../memory-boundaries.js";
-import type { MemoryEntry, MemoryStore } from "../store.js";
-import type { LLMClient } from "../llm-client.js";
-import type { SynthesisVerdict } from "../synthesis-contract.js";
-import type { Embedder } from "../embedder.js";
-import { cosineSimilarity } from "../multi-vector.js";
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-function makeEntry(overrides: Partial<MemoryEntry> & { id: string; text: string }): MemoryEntry {
-  return {
-    vector: [1, 0, 0],
-    category: "events",
-    scope: "project:test",
-    importance: 0.7,
-    timestamp: Date.now(),
-    metadata: JSON.stringify({
-      evolution: {
-        status: "active",
-        version: 1,
-        accessCount: 0,
-        lastAccessedAt: null,
-        supersededBy: null,
-        consolidatedInto: null,
-        sourceMemories: [],
-        validFrom: Date.now(),
-        validUntil: null,
-      },
-    }),
-    ...overrides,
-  };
-}
-
-/** Create a mock store that tracks store() and update() calls.
- *  可选 seed：模拟"库中已有行"的 metadata（patchMetadataBatch 的生产语义是以库中
- *  最新行起底应用 patchFn——不给 seed 时起底为空对象）。 */
-function createMockStore(seed: MemoryEntry[] = []) {
-  const stored: MemoryEntry[] = [];
-  const updates: Array<{ id: string; metadata: string }> = [];
-  // 2026-08-14: patchMetadataBatch 的最新态表 —— patchFn 以上一批的结果起底，
-  // 忠实模拟生产语义（锁内最新行起底、批间叠加而非互抹）。
-  const metaById = new Map<string, Record<string, unknown>>();
-  for (const e of seed) {
-    try { metaById.set(e.id, JSON.parse(e.metadata || "{}") as Record<string, unknown>); } catch { /* skip bad seed */ }
-  }
-  let storeCounter = 0;
-
-  const store: Pick<MemoryStore, "store" | "update" | "patchMetadataBatch"> = {
-    async store(entry) {
-      const full: MemoryEntry = {
-        ...entry,
-        id: entry.id || `insight-${storeCounter++}`,
-        timestamp: Date.now(),
-        metadata: entry.metadata || "{}",
-      };
-      stored.push(full);
-      return full;
-    },
-    async update(id, upd, _scopeFilter?) {
-      if (upd.metadata) {
-        updates.push({ id, metadata: upd.metadata });
-      }
-      return { id, text: "", vector: [], category: "events", scope: "project:test", importance: 0.5, timestamp: Date.now(), metadata: upd.metadata || "{}" } as MemoryEntry;
-    },
-    async patchMetadataBatch(patches, _scopeFilter?) {
-      for (const { id, patchFn } of patches) {
-        const current = metaById.get(id) ?? {};
-        const entry = { id, text: "", vector: [], category: "events", scope: "project:test", importance: 0.5, timestamp: Date.now(), metadata: JSON.stringify(current) } as MemoryEntry;
-        const patched = patchFn(current, entry);
-        metaById.set(id, patched);
-        updates.push({ id, metadata: JSON.stringify(patched) });
-      }
-      return patches.length;
-    },
-  };
-
-  return { store, stored, updates, metaById };
-}
-
-/**
- * Create a mock LLM that returns a fixed insight string (or null to simulate abstention).
- *
- * 2026-08-23：合成接口从「返回 string|null」换成 `SynthesisVerdict`（产出 / 弃权 /
- * 校验不过三态）。这个 helper 保留旧的字符串签名，把 null 映射成 `abstained` ——
- * 既有 30 多条断言测的是聚类与写库行为，不该因为合成签名换代而全部重写。
- * 三态本身另有直接断言（见文件末尾「合成契约」一节）。
- */
-function synthOk(text: string, evidence: number[] = [1, 2]): SynthesisVerdict {
-  return { status: "ok", output: { text, evidence } };
-}
-
-function createMockLLM(
-  insightFn: (text: string) => string | null,
-  patternFn?: (texts: string[]) => string | null,
-): Pick<LLMClient, "synthesizeClusterInsight" | "synthesizeClusterPattern"> {
-  return {
-    async synthesizeClusterInsight(texts: string[]) {
-      const out = insightFn(texts.join("\n---\n"));
-      return out === null ? { status: "abstained" } : synthOk(out);
-    },
-    async synthesizeClusterPattern(texts: string[]) {
-      const out = patternFn ? patternFn(texts) : null;
-      return out === null ? { status: "abstained" } : synthOk(out);
-    },
-  } as Pick<LLMClient, "synthesizeClusterInsight" | "synthesizeClusterPattern">;
-}
-
-/** Create a mock embedder that returns a fixed vector */
-function createMockEmbedder(vector: number[] = [0.5, 0.5, 0.5]): Pick<Embedder, "embedPassage"> {
-  return {
-    async embedPassage(_text: string) {
-      return vector;
-    },
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
-describe("clusterAndConsolidate", () => {
-  it("returns zeros for empty entries", async () => {
-    const { store } = createMockStore();
-    const llm = createMockLLM(() => "insight");
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries: [],
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-    });
-
-    expect(result.clustersFound).toBe(0);
-    expect(result.clustersConsolidated).toBe(0);
-    expect(result.insightsGenerated).toBe(0);
-    expect(result.entriesLinked).toBe(0);
-  });
-
-  it("returns 0 consolidated when all clusters are below minClusterSize", async () => {
-    // 2 entries each with different enough vectors to not cluster
-    const entries = [
-      makeEntry({ id: "a", text: "TypeScript patterns", vector: [1, 0, 0] }),
-      makeEntry({ id: "b", text: "Python patterns", vector: [0, 1, 0] }),
-    ];
-
-    const { store } = createMockStore();
-    const llm = createMockLLM(() => "insight");
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-    });
-
-    expect(result.clustersFound).toBe(0);
-    expect(result.clustersConsolidated).toBe(0);
-    expect(result.insightsGenerated).toBe(0);
-  });
-
-  it("clusters similar entries and generates insights", async () => {
-    // 3 entries with very similar vectors — should form one cluster
-    const entries = [
-      makeEntry({ id: "a", text: "TypeScript is great for large projects", vector: [0.9, 0.1, 0], importance: 0.8 }),
-      makeEntry({ id: "b", text: "TypeScript helps with code safety", vector: [0.88, 0.12, 0], importance: 0.7 }),
-      makeEntry({ id: "c", text: "TypeScript improves developer experience", vector: [0.92, 0.08, 0], importance: 0.6 }),
-    ];
-
-    const { store, stored, updates } = createMockStore(entries);
-    const llm = createMockLLM(() => "TypeScript benefits for development");
-    const embedder = createMockEmbedder([0.5, 0.5, 0]);
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-    });
-
-    expect(result.clustersFound).toBe(1);
-    expect(result.clustersConsolidated).toBe(1);
-    expect(result.insightsGenerated).toBe(1);
-    expect(result.entriesLinked).toBe(3);
-
-    // Verify insight was stored
-    expect(stored.length).toBe(1);
-    expect(stored[0].text).toBe("TypeScript benefits for development");
-    expect(stored[0].importance).toBe(0.8); // max of cluster
-    expect(stored[0].category).toBe("events"); // majority category
-
-    // Verify insight metadata has sourceMemories
-    const insightMeta = JSON.parse(stored[0].metadata!);
-    expect(insightMeta.evolution.sourceMemories).toEqual(["a", "b", "c"]);
-    expect(insightMeta.cluster_insight).toBe(true);
-
-    // Verify source memories were marked with consolidatedInto
-    expect(updates.length).toBe(3);
-    for (const upd of updates) {
-      const meta = JSON.parse(upd.metadata);
-      expect(meta.evolution.consolidatedInto).toBe(stored[0].id);
-      // Status should remain active (not changed)
-      expect(meta.evolution.status).toBe("active");
-    }
-  });
-
-  // 2026-08-14 Bug-2 回归：旧路径 insight 源回写与 pattern 源回写都从同一个旧内存串
-  // 起底 patch，后者会把前者刚写库的 consolidatedInto 抹掉——凡走到 pattern 抽取的
-  // cluster，源条目的 consolidatedInto 全丢。新路径两段批量都以最新态起底，叠加共存。
-  it("Bug-2 回归：pattern 源回写后 consolidatedInto 与 contributedToPattern 并存（最终态）", async () => {
-    const entries = [
-      makeEntry({ id: "a", text: "TypeScript is great", vector: [0.9, 0.1, 0], importance: 0.8 }),
-      makeEntry({ id: "b", text: "TypeScript is safe", vector: [0.88, 0.12, 0], importance: 0.7 }),
-      makeEntry({ id: "c", text: "TypeScript is productive", vector: [0.92, 0.08, 0], importance: 0.6 }),
-    ];
-    const { store, stored, metaById } = createMockStore(entries);
-    const llm = createMockLLM(() => "TS insight", () => "TS pattern");
-    const embedder = createMockEmbedder([0.5, 0.5, 0]);
-
-    const result = await clusterAndConsolidate({
-      entries, embedder, llm: llm as unknown as LLMClient, store,
-      scope: "project:test", minClusterSize: 3, clusterThreshold: 0.75,
-      extractPatterns: true,
-    });
-
-    expect(result.insightsGenerated).toBe(1);
-    expect(result.patternsExtracted).toBe(1);
-    const insight = stored.find(e => JSON.parse(e.metadata!).cluster_insight === true)!;
-    const pattern = stored.find(e => JSON.parse(e.metadata!).cross_memory_pattern === true)!;
-    for (const id of ["a", "b", "c"]) {
-      const final = metaById.get(id) as { evolution: Record<string, unknown> };
-      expect(final.evolution.consolidatedInto).toBe(insight.id); // 旧路径这里被 pattern 批抹成 undefined
-      expect(final.evolution.contributedToPattern).toBe(pattern.id);
-      expect(final.evolution.status).toBe("active"); // 3b 不动 status
-    }
-  });
-
-  // P0-2/P1-2: insight/pattern idempotency — deterministic id from source cluster ids.
-  it("re-running on the same cluster yields a stable, deterministic insight id", async () => {
-    const entries = [
-      makeEntry({ id: "a", text: "TypeScript is great for large projects", vector: [0.9, 0.1, 0], importance: 0.8 }),
-      makeEntry({ id: "b", text: "TypeScript helps with code safety", vector: [0.88, 0.12, 0], importance: 0.7 }),
-      makeEntry({ id: "c", text: "TypeScript improves developer experience", vector: [0.92, 0.08, 0], importance: 0.6 }),
-    ];
-    const llm = createMockLLM(() => "TypeScript benefits for development");
-    const embedder = createMockEmbedder([0.5, 0.5, 0]);
-
-    const run1 = createMockStore();
-    await clusterAndConsolidate({
-      entries, embedder, llm: llm as unknown as LLMClient, store: run1.store,
-      scope: "project:test", minClusterSize: 3, clusterThreshold: 0.75,
-    });
-    const run2 = createMockStore();
-    await clusterAndConsolidate({
-      entries, embedder, llm: llm as unknown as LLMClient, store: run2.store,
-      scope: "project:test", minClusterSize: 3, clusterThreshold: 0.75,
-    });
-
-    // Same source cluster ⇒ identical deterministic id across runs (upsert dedups downstream).
-    expect(run1.stored[0].id).toBe(run2.stored[0].id);
-    // Must be the engine-supplied deterministic id, not the mock counter fallback.
-    expect(run1.stored[0].id).not.toMatch(/^insight-\d+$/);
-  });
-
-  it("an upsert-like (dedup-by-id) store keeps a single insight across repeated runs", async () => {
-    const entries = [
-      makeEntry({ id: "a", text: "TypeScript is great for large projects", vector: [0.9, 0.1, 0], importance: 0.8 }),
-      makeEntry({ id: "b", text: "TypeScript helps with code safety", vector: [0.88, 0.12, 0], importance: 0.7 }),
-      makeEntry({ id: "c", text: "TypeScript improves developer experience", vector: [0.92, 0.08, 0], importance: 0.6 }),
-    ];
-    const llm = createMockLLM(() => "TypeScript benefits for development");
-    const embedder = createMockEmbedder([0.5, 0.5, 0]);
-
-    const byId = new Map<string, MemoryEntry>();
-    const dedupStore: Pick<MemoryStore, "store" | "update"> = {
-      async store(entry) {
-        const full = {
-          ...entry,
-          id: entry.id || `insight-${byId.size}`,
-          timestamp: Date.now(),
-          metadata: entry.metadata || "{}",
-        } as MemoryEntry;
-        byId.set(full.id, full); // same id overwrites (upsert semantics)
-        return full;
-      },
-      async update(id, upd) {
-        return { id, text: "", vector: [], category: "events", scope: "project:test", importance: 0.5, timestamp: Date.now(), metadata: upd.metadata || "{}" } as MemoryEntry;
-      },
-      async patchMetadataBatch(patches: Array<{ id: string; patchFn: (meta: Record<string, unknown>, entry: MemoryEntry) => Record<string, unknown> }>) {
-        return patches.length; // 本用例只断言 insight 幂等，源回写记录不参与断言
-      },
-    };
-
-    const params = {
-      entries, embedder, llm: llm as unknown as LLMClient, store: dedupStore,
-      scope: "project:test", minClusterSize: 3, clusterThreshold: 0.75,
-    };
-    await clusterAndConsolidate(params);
-    await clusterAndConsolidate(params);
-
-    const insights = [...byId.values()].filter((e) => {
-      try {
-        return JSON.parse(e.metadata!).cluster_insight === true;
-      } catch {
-        return false;
-      }
-    });
-    expect(insights.length).toBe(1);
-  });
-
-  it("skips non-active entries", async () => {
-    const entries = [
-      makeEntry({ id: "a", text: "active memory", vector: [0.9, 0.1, 0] }),
-      makeEntry({
-        id: "b", text: "archived memory", vector: [0.88, 0.12, 0],
-        metadata: JSON.stringify({ evolution: { status: "archived", version: 1, accessCount: 0, lastAccessedAt: null, supersededBy: null, consolidatedInto: null, sourceMemories: [], validFrom: Date.now(), validUntil: null } }),
-      }),
-      makeEntry({ id: "c", text: "another active", vector: [0.92, 0.08, 0] }),
-    ];
-
-    const { store } = createMockStore();
-    const llm = createMockLLM(() => "insight");
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-    });
-
-    // Only 2 active entries — not enough for a cluster of 3
-    expect(result.clustersFound).toBe(0);
-    expect(result.insightsGenerated).toBe(0);
-  });
-
-  it("handles LLM failure gracefully (returns null insight)", async () => {
-    const entries = [
-      makeEntry({ id: "a", text: "memory A", vector: [0.9, 0.1, 0] }),
-      makeEntry({ id: "b", text: "memory B", vector: [0.88, 0.12, 0] }),
-      makeEntry({ id: "c", text: "memory C", vector: [0.92, 0.08, 0] }),
-    ];
-
-    const { store, stored } = createMockStore();
-    const llm = createMockLLM(() => null); // LLM fails
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-    });
-
-    expect(result.clustersFound).toBe(1);
-    expect(result.clustersConsolidated).toBe(1); // Still counts as processed
-    expect(result.insightsGenerated).toBe(0); // No insight generated
-    expect(stored.length).toBe(0); // Nothing stored
-    expect(result.llmFailures).toBe(0); // 返回 null 不是失败，是合法的"没料可炼"
-  });
-
-  // 2026-08-13：上面那条测的是 generateL0 **返回 null**；下面这条测它 **抛异常**。
-  // 两者此前走的是完全不同的路径 —— 返回 null 被消化，抛异常会一路冒出 runDream，
-  // 把整个 scope 的 dream 炸掉（llm-client 的 chat() 在 catch 里是 `throw err`）。
-  // 2026-08-09 memory 周日轮次连挂两次就是这条路径：15s AbortController 超时。
-  it("单个 cluster 的 LLM 抛异常时吸收掉，不炸整轮（2026-08-09 memory 轮次根因）", async () => {
-    const entries = [
-      makeEntry({ id: "a", text: "memory A", vector: [0.9, 0.1, 0] }),
-      makeEntry({ id: "b", text: "memory B", vector: [0.88, 0.12, 0] }),
-      makeEntry({ id: "c", text: "memory C", vector: [0.92, 0.08, 0] }),
-    ];
-
-    const { store, stored } = createMockStore();
-    const llm = {
-      async synthesizeClusterInsight(_texts: string[]): Promise<SynthesisVerdict> {
-        throw new Error("Request was aborted.");
-      },
-      async synthesizeClusterPattern(_texts: string[]): Promise<SynthesisVerdict> {
-        return { status: "abstained" };
-      },
-    };
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-    });
-
-    // 关键断言：函数正常返回而不是抛出。修复前这一行根本到不了 —— 异常直接冒到调用方。
-    expect(result.clustersFound).toBe(1);
-    expect(result.clustersConsolidated).toBe(1);
-    expect(result.insightsGenerated).toBe(0);
-    expect(stored.length).toBe(0);
-    // 吸收 ≠ 静默：失败要计数，否则"LLM 全程不可用"和"今天没料可炼"长得一样。
-    expect(result.llmFailures).toBe(1);
-  });
-
-  it("多个 cluster 时，一个 LLM 抛异常不影响其他 cluster 产出", async () => {
-    // 两个互相正交的簇，各 3 个成员
-    const entries = [
-      makeEntry({ id: "a1", text: "cluster one A", vector: [0.9, 0.1, 0] }),
-      makeEntry({ id: "a2", text: "cluster one B", vector: [0.88, 0.12, 0] }),
-      makeEntry({ id: "a3", text: "cluster one C", vector: [0.92, 0.08, 0] }),
-      makeEntry({ id: "b1", text: "cluster two A", vector: [0, 0.9, 0.1] }),
-      makeEntry({ id: "b2", text: "cluster two B", vector: [0, 0.88, 0.12] }),
-      makeEntry({ id: "b3", text: "cluster two C", vector: [0, 0.92, 0.08] }),
-    ];
-
-    const { store, stored } = createMockStore();
-    let call = 0;
-    const llm = {
-      async synthesizeClusterInsight(_texts: string[]): Promise<SynthesisVerdict> {
-        call++;
-        if (call === 1) throw new Error("Request was aborted.");
-        return synthOk("第二个簇的 insight");
-      },
-      async synthesizeClusterPattern(_texts: string[]): Promise<SynthesisVerdict> {
-        return { status: "abstained" };
-      },
-    };
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-    });
-
-    expect(result.clustersFound).toBe(2);
-    expect(result.llmFailures).toBe(1);
-    // 修复前：第一个簇抛异常 → 整个函数炸掉 → 第二个簇永远跑不到，产出为 0。
-    expect(result.insightsGenerated).toBe(1);
-    expect(stored.length).toBe(1);
-    expect(stored[0].text).toBe("第二个簇的 insight");
-  });
-
-  it("pattern 抽取抛异常时只丢这一簇的 pattern，已写好的 insight 不连坐", async () => {
-    const entries = [
-      makeEntry({ id: "a", text: "memory A", vector: [0.9, 0.1, 0] }),
-      makeEntry({ id: "b", text: "memory B", vector: [0.88, 0.12, 0] }),
-      makeEntry({ id: "c", text: "memory C", vector: [0.92, 0.08, 0] }),
-    ];
-
-    const { store, stored } = createMockStore();
-    const llm = {
-      async synthesizeClusterInsight(_texts: string[]): Promise<SynthesisVerdict> {
-        return synthOk("insight 正常产出");
-      },
-      async synthesizeClusterPattern(_texts: string[]): Promise<SynthesisVerdict> {
-        throw new Error("Request was aborted.");
-      },
-    };
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-      extractPatterns: true,
-    });
-
-    expect(result.llmFailures).toBe(1);
-    expect(result.patternsExtracted).toBe(0);
-    // insight 已经写进去了，不该被 pattern 阶段的失败拖掉
-    expect(result.insightsGenerated).toBe(1);
-    expect(stored.length).toBe(1);
-    expect(stored[0].text).toBe("insight 正常产出");
-  });
-
-  it("respects maxClusters limit", async () => {
-    // Create 2 distinct clusters, each with 3 members
-    const entries = [
-      // Cluster 1: similar vectors near [1, 0, 0]
-      makeEntry({ id: "a1", text: "cluster 1 member A", vector: [0.95, 0.05, 0] }),
-      makeEntry({ id: "a2", text: "cluster 1 member B", vector: [0.93, 0.07, 0] }),
-      makeEntry({ id: "a3", text: "cluster 1 member C", vector: [0.97, 0.03, 0] }),
-      // Cluster 2: similar vectors near [0, 1, 0]
-      makeEntry({ id: "b1", text: "cluster 2 member A", vector: [0.05, 0.95, 0] }),
-      makeEntry({ id: "b2", text: "cluster 2 member B", vector: [0.07, 0.93, 0] }),
-      makeEntry({ id: "b3", text: "cluster 2 member C", vector: [0.03, 0.97, 0] }),
-    ];
-
-    const { store } = createMockStore();
-    const llm = createMockLLM(() => "consolidated insight");
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-      maxClusters: 1, // Only process 1 cluster
-    });
-
-    expect(result.clustersFound).toBe(2);
-    expect(result.clustersConsolidated).toBe(1); // Only 1 processed
-    expect(result.insightsGenerated).toBe(1);
-  });
-
-  it("uses majority vote for category selection", async () => {
-    const entries = [
-      makeEntry({ id: "a", text: "pattern A", vector: [0.9, 0.1, 0], category: "patterns" }),
-      makeEntry({ id: "b", text: "pattern B", vector: [0.88, 0.12, 0], category: "patterns" }),
-      makeEntry({ id: "c", text: "event C", vector: [0.92, 0.08, 0], category: "events" }),
-    ];
-
-    const { store, stored } = createMockStore();
-    const llm = createMockLLM(() => "common pattern insight");
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-    });
-
-    expect(result.insightsGenerated).toBe(1);
-    expect(stored[0].category).toBe("patterns"); // majority = patterns (2 vs 1)
-  });
-
-  // CC-9: Diminishing returns early stop
-  it("triggers earlyStop after 2 consecutive low-yield rounds", async () => {
-    // Create 4 clusters, each with 3 members. LLM returns null for all.
-    const entries = [
-      // Cluster 1
-      makeEntry({ id: "a1", text: "c1a", vector: [0.95, 0.05, 0, 0] }),
-      makeEntry({ id: "a2", text: "c1b", vector: [0.93, 0.07, 0, 0] }),
-      makeEntry({ id: "a3", text: "c1c", vector: [0.97, 0.03, 0, 0] }),
-      // Cluster 2
-      makeEntry({ id: "b1", text: "c2a", vector: [0.05, 0.95, 0, 0] }),
-      makeEntry({ id: "b2", text: "c2b", vector: [0.07, 0.93, 0, 0] }),
-      makeEntry({ id: "b3", text: "c2c", vector: [0.03, 0.97, 0, 0] }),
-      // Cluster 3
-      makeEntry({ id: "c1", text: "c3a", vector: [0, 0.05, 0.95, 0] }),
-      makeEntry({ id: "c2", text: "c3b", vector: [0, 0.07, 0.93, 0] }),
-      makeEntry({ id: "c3", text: "c3c", vector: [0, 0.03, 0.97, 0] }),
-      // Cluster 4
-      makeEntry({ id: "d1", text: "c4a", vector: [0, 0, 0.05, 0.95] }),
-      makeEntry({ id: "d2", text: "c4b", vector: [0, 0, 0.07, 0.93] }),
-      makeEntry({ id: "d3", text: "c4c", vector: [0, 0, 0.03, 0.97] }),
-    ];
-
-    const { store } = createMockStore();
-    // LLM always fails → 0 insights per round → consecutive low yield
-    const llm = createMockLLM(() => null);
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-      maxClusters: 10, // Allow many clusters
-    });
-
-    expect(result.clustersFound).toBe(4);
-    // Should stop after 2 consecutive failures + then earlyStop on 3rd
-    expect(result.clustersConsolidated).toBe(2);
-    expect(result.earlyStop).toBe("diminishing_returns");
-    expect(result.insightsGenerated).toBe(0);
-  });
-
-  it("does not trigger earlyStop when insights are consistently generated", async () => {
-    // Create 3 clusters, LLM always succeeds
-    const entries = [
-      // Cluster 1
-      makeEntry({ id: "a1", text: "c1a", vector: [0.95, 0.05, 0] }),
-      makeEntry({ id: "a2", text: "c1b", vector: [0.93, 0.07, 0] }),
-      makeEntry({ id: "a3", text: "c1c", vector: [0.97, 0.03, 0] }),
-      // Cluster 2
-      makeEntry({ id: "b1", text: "c2a", vector: [0.05, 0.95, 0] }),
-      makeEntry({ id: "b2", text: "c2b", vector: [0.07, 0.93, 0] }),
-      makeEntry({ id: "b3", text: "c2c", vector: [0.03, 0.97, 0] }),
-      // Cluster 3
-      makeEntry({ id: "c1", text: "c3a", vector: [0, 0.05, 0.95] }),
-      makeEntry({ id: "c2", text: "c3b", vector: [0, 0.07, 0.93] }),
-      makeEntry({ id: "c3", text: "c3c", vector: [0, 0.03, 0.97] }),
-    ];
-
-    const { store } = createMockStore();
-    const llm = createMockLLM(() => "great insight");
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-      maxClusters: 10,
-    });
-
-    expect(result.clustersFound).toBe(3);
-    expect(result.clustersConsolidated).toBe(3);
-    expect(result.insightsGenerated).toBe(3);
-    expect(result.earlyStop).toBeUndefined();
-  });
-
-  it("resets consecutive low-yield counter when a good round occurs", async () => {
-    // 3 clusters: first fails, second succeeds, third fails.
-    // Counter resets after second cluster, so no earlyStop.
-    let callCount = 0;
-    const entries = [
-      // Cluster 1
-      makeEntry({ id: "a1", text: "c1a", vector: [0.95, 0.05, 0] }),
-      makeEntry({ id: "a2", text: "c1b", vector: [0.93, 0.07, 0] }),
-      makeEntry({ id: "a3", text: "c1c", vector: [0.97, 0.03, 0] }),
-      // Cluster 2
-      makeEntry({ id: "b1", text: "c2a", vector: [0.05, 0.95, 0] }),
-      makeEntry({ id: "b2", text: "c2b", vector: [0.07, 0.93, 0] }),
-      makeEntry({ id: "b3", text: "c2c", vector: [0.03, 0.97, 0] }),
-      // Cluster 3
-      makeEntry({ id: "c1", text: "c3a", vector: [0, 0.05, 0.95] }),
-      makeEntry({ id: "c2", text: "c3b", vector: [0, 0.07, 0.93] }),
-      makeEntry({ id: "c3", text: "c3c", vector: [0, 0.03, 0.97] }),
-    ];
-
-    const { store } = createMockStore();
-    // Pattern: fail, succeed, fail — should NOT earlyStop (counter resets)
-    const llm = createMockLLM(() => {
-      callCount++;
-      // Cluster ordering depends on greedy algorithm; 1st and 3rd fail, 2nd succeeds
-      if (callCount === 2) return "good insight";
-      return null;
-    });
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-      maxClusters: 10,
-    });
-
-    expect(result.clustersConsolidated).toBe(3); // All 3 processed
-    expect(result.insightsGenerated).toBe(1);
-    expect(result.earlyStop).toBeUndefined(); // No early stop
-  });
-});
-
-// ---------------------------------------------------------------------------
-// HP-5: Cross-Memory Pattern Extraction
-// ---------------------------------------------------------------------------
-
-describe("clusterAndConsolidate — pattern extraction (HP-5)", () => {
-  it("extracts pattern when extractPatterns=true and LLM returns pattern", async () => {
-    const entries = [
-      makeEntry({ id: "a", text: "用户喜欢吃寿司", vector: [0.9, 0.1, 0], importance: 0.8 }),
-      makeEntry({ id: "b", text: "用户经常去日料店", vector: [0.88, 0.12, 0], importance: 0.7 }),
-      makeEntry({ id: "c", text: "用户提到最近学做天妇罗", vector: [0.92, 0.08, 0], importance: 0.6 }),
-    ];
-
-    const { store, stored, updates } = createMockStore();
-    const llm = createMockLLM(
-      () => "用户对日本料理有广泛兴趣",
-      () => "用户反复提及日料相关话题，暗示对日本饮食文化有持久偏好",
-    );
-    const embedder = createMockEmbedder([0.5, 0.5, 0]);
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-      extractPatterns: true,
-    });
-
-    expect(result.patternsExtracted).toBe(1);
-    expect(result.insightsGenerated).toBe(1);
-
-    // Should have stored 2 entries: 1 insight + 1 pattern
-    expect(stored.length).toBe(2);
-
-    const patternEntry = stored.find(s => {
-      const meta = JSON.parse(s.metadata!);
-      return meta.cross_memory_pattern === true;
-    });
-    expect(patternEntry).toBeDefined();
-    expect(patternEntry!.text).toContain("日料");
-    expect(patternEntry!.category).toBe("patterns");
-    expect(patternEntry!.importance).toBeCloseTo(0.8, 5); // = max(0.8)，继承不加成
-
-    const patternMeta = JSON.parse(patternEntry!.metadata!);
-    expect(patternMeta.source_cluster_size).toBe(3);
-    expect(patternMeta.evolution.sourceMemories).toEqual(["a", "b", "c"]);
-
-    // Source memories should have contributedToPattern set
-    const patternUpdates = updates.filter(u => {
-      const meta = JSON.parse(u.metadata);
-      return meta.evolution?.contributedToPattern === patternEntry!.id;
-    });
-    expect(patternUpdates.length).toBe(3);
-  });
-
-  it("does not extract patterns when extractPatterns=false (default)", async () => {
-    const entries = [
-      makeEntry({ id: "a", text: "memory A", vector: [0.9, 0.1, 0], importance: 0.8 }),
-      makeEntry({ id: "b", text: "memory B", vector: [0.88, 0.12, 0], importance: 0.7 }),
-      makeEntry({ id: "c", text: "memory C", vector: [0.92, 0.08, 0], importance: 0.6 }),
-    ];
-
-    const { store, stored } = createMockStore();
-    const llm = createMockLLM(
-      () => "insight text",
-      () => "should not appear",
-    );
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-      // extractPatterns defaults to false
-    });
-
-    expect(result.patternsExtracted).toBe(0);
-    expect(stored.length).toBe(1); // Only the insight, no pattern
-  });
-
-  it("handles pattern extraction failure gracefully", async () => {
-    const entries = [
-      makeEntry({ id: "a", text: "memory A", vector: [0.9, 0.1, 0] }),
-      makeEntry({ id: "b", text: "memory B", vector: [0.88, 0.12, 0] }),
-      makeEntry({ id: "c", text: "memory C", vector: [0.92, 0.08, 0] }),
-    ];
-
-    const { store, stored } = createMockStore();
-    const llm = createMockLLM(
-      () => "insight text",
-      () => null, // pattern extraction fails
-    );
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-      extractPatterns: true,
-    });
-
-    expect(result.patternsExtracted).toBe(0);
-    expect(result.insightsGenerated).toBe(1);
-    expect(stored.length).toBe(1); // Only insight stored
-  });
-
-  it("pattern importance 继承源里最高的，不再加成后撞上限", async () => {
-    const entries = [
-      makeEntry({ id: "a", text: "high importance A", vector: [0.9, 0.1, 0], importance: 0.95 }),
-      makeEntry({ id: "b", text: "high importance B", vector: [0.88, 0.12, 0], importance: 0.98 }),
-      makeEntry({ id: "c", text: "high importance C", vector: [0.92, 0.08, 0], importance: 0.93 }),
-    ];
-
-    const { store, stored } = createMockStore();
-    const llm = createMockLLM(
-      () => "insight",
-      () => "discovered pattern",
-    );
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-      extractPatterns: true,
-    });
-
-    expect(result.patternsExtracted).toBe(1);
-    const patternEntry = stored.find(s => JSON.parse(s.metadata!).cross_memory_pattern);
-    // 旧行为：max(0.98) + 0.1 = 1.08 → 撞 1.0 上限，派生物顶格。
-    // 现在直接取 max(0.98)，不存在需要 cap 的情形。
-    expect(patternEntry!.importance).toBeCloseTo(0.98, 5);
-    // 注意这里源本身就在 pin 带（0.98 >= 0.95），派生物照样继承进去。
-    // 「派生物不该继承人工 pin 身份」是另一个问题，单独立项，不在本次改动范围。
-  });
-
-  it("源都在 pin 线以下时，pattern 不再被加成推过 0.95", async () => {
-    // 这是加成最有害的形态：源里最高只有 0.85，本不该享有人工 pin 的待遇，
-    // 旧行为 0.85 + 0.1 = 0.95 正好跨进那个频段，于是这条 LLM 抽出来的 pattern
-    // 自动拿到永不归档（auto-gc.ts）和永不衰减（decay-engine.ts）的保护。
-    const entries = [
-      makeEntry({ id: "a", text: "topic A", vector: [0.9, 0.1, 0], importance: 0.85 }),
-      makeEntry({ id: "b", text: "topic B", vector: [0.88, 0.12, 0], importance: 0.8 }),
-      makeEntry({ id: "c", text: "topic C", vector: [0.92, 0.08, 0], importance: 0.75 }),
-    ];
-
-    const { store, stored } = createMockStore();
-    const llm = createMockLLM(
-      () => "insight",
-      () => "discovered pattern",
-    );
-    const embedder = createMockEmbedder();
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder,
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      minClusterSize: 3,
-      clusterThreshold: 0.75,
-      extractPatterns: true,
-    });
-
-    expect(result.patternsExtracted).toBe(1);
-    const patternEntry = stored.find(s => JSON.parse(s.metadata!).cross_memory_pattern);
-    expect(patternEntry!.importance).toBeCloseTo(0.85, 5);
-    expect(patternEntry!.importance).toBeLessThan(0.95);
-
-    // 派生物也不该压过它自己的源
-    const maxSource = Math.max(...entries.map(e => e.importance));
-    expect(patternEntry!.importance).toBeLessThanOrEqual(maxSource);
-  });
-});
-
-describe("cosineSimilarity (used by cluster consolidation)", () => {
-  it("returns 1.0 for identical vectors", () => {
-    expect(cosineSimilarity([1, 0, 0], [1, 0, 0])).toBeCloseTo(1.0, 5);
-  });
-
-  it("returns 0.0 for orthogonal vectors", () => {
-    expect(cosineSimilarity([1, 0, 0], [0, 1, 0])).toBeCloseTo(0.0, 5);
-  });
-
-  it("returns -1.0 for opposite vectors", () => {
-    expect(cosineSimilarity([1, 0, 0], [-1, 0, 0])).toBeCloseTo(-1.0, 5);
-  });
-
-  it("returns 0 for empty vectors", () => {
-    expect(cosineSimilarity([], [])).toBe(0);
-  });
-
-  it("returns 0 for mismatched dimensions", () => {
-    expect(cosineSimilarity([1, 0], [1, 0, 0])).toBe(0);
-  });
-
-  it("correctly computes similarity for non-trivial vectors", () => {
-    // [1, 1] and [1, 0] -> cos = 1 / sqrt(2) ≈ 0.7071
-    expect(cosineSimilarity([1, 1], [1, 0])).toBeCloseTo(1 / Math.sqrt(2), 5);
-  });
-});
-
-// ---------------------------------------------------------------------------
-// LC-P2: Cluster-aware deduplication
-// ---------------------------------------------------------------------------
-
-describe("deduplicateByClusterInsight (LC-P2)", () => {
-  function makeResult(id: string, text: string, meta?: Record<string, unknown>) {
-    return {
-      entry: {
-        id,
-        text,
-        vector: [1, 0, 0],
-        category: "events" as const,
-        scope: "project:test",
-        importance: 0.7,
-        timestamp: Date.now(),
-        metadata: meta ? JSON.stringify(meta) : "{}",
-      },
-      score: 0.8,
-    };
-  }
-
-  it("removes source memories when cluster insight is present", () => {
-    const results = [
-      makeResult("insight-1", "cluster summary about TypeScript", {
-        cluster_insight: true,
-        evolution: { sourceMemories: ["src-a", "src-b", "src-c"] },
-      }),
-      makeResult("src-a", "TypeScript is great"),
-      makeResult("src-b", "TypeScript helps safety"),
-      makeResult("other", "unrelated memory"),
-    ];
-
-    const deduped = deduplicateByClusterInsight(results);
-    expect(deduped.length).toBe(2);
-    expect(deduped.map(r => r.entry.id)).toEqual(["insight-1", "other"]);
-  });
-
-  it("also deduplicates cross_memory_pattern source memories", () => {
-    const results = [
-      makeResult("pattern-1", "user likes Japanese food", {
-        cross_memory_pattern: true,
-        evolution: { sourceMemories: ["m1", "m2", "m3"] },
-      }),
-      makeResult("m1", "user eats sushi"),
-      makeResult("m2", "user visits ramen shop"),
-      makeResult("unrelated", "something else"),
-    ];
-
-    const deduped = deduplicateByClusterInsight(results);
-    expect(deduped.length).toBe(2);
-    expect(deduped.map(r => r.entry.id)).toEqual(["pattern-1", "unrelated"]);
-  });
-
-  it("passes through all results when no cluster insights exist", () => {
-    const results = [
-      makeResult("a", "memory A"),
-      makeResult("b", "memory B"),
-      makeResult("c", "memory C"),
-    ];
-
-    const deduped = deduplicateByClusterInsight(results);
-    expect(deduped.length).toBe(3);
-  });
-
-  it("handles empty results", () => {
-    expect(deduplicateByClusterInsight([])).toEqual([]);
-  });
-
-  it("keeps source memories that are NOT in the result set", () => {
-    // Insight references src-a, src-b, src-c but only src-a is in results
-    const results = [
-      makeResult("insight-1", "summary", {
-        cluster_insight: true,
-        evolution: { sourceMemories: ["src-a", "src-b", "src-c"] },
-      }),
-      makeResult("src-a", "one source"),
-      makeResult("independent", "not a source"),
-    ];
-
-    const deduped = deduplicateByClusterInsight(results);
-    expect(deduped.length).toBe(2);
-    expect(deduped.map(r => r.entry.id)).toEqual(["insight-1", "independent"]);
-  });
-
-  it("handles malformed metadata gracefully", () => {
-    const results = [
-      {
-        entry: {
-          id: "bad",
-          text: "bad metadata",
-          vector: [1, 0, 0],
-          category: "events" as const,
-          scope: "test",
-          importance: 0.5,
-          timestamp: Date.now(),
-          metadata: "not-json{{{",
-        },
-        score: 0.5,
-      },
-      makeResult("normal", "normal memory"),
-    ];
-
-    const deduped = deduplicateByClusterInsight(results);
-    expect(deduped.length).toBe(2); // Both pass through
-  });
-});
-
-// ---------------------------------------------------------------------------
-// 2026-08-23 合成契约上线带来的三件行为改动
-// ---------------------------------------------------------------------------
-
-/** 造一个三成员簇（向量足够接近，一定聚成一簇）。 */
-function trioEntries(): MemoryEntry[] {
-  return [
-    makeEntry({ id: "a", text: "记录 A", vector: [0.9, 0.1, 0], importance: 0.8 }),
-    makeEntry({ id: "b", text: "记录 B", vector: [0.88, 0.12, 0], importance: 0.7 }),
-    makeEntry({ id: "c", text: "记录 C", vector: [0.92, 0.08, 0], importance: 0.6 }),
-  ];
-}
-
-const trioParams = { minClusterSize: 3, clusterThreshold: 0.75 };
-
-describe("合成弃权路径（老 generateL0 完全没有这条路）", () => {
-  it("模型判定「没料可炼」时不写库，且记进 synthesisAbstained", async () => {
-    const { store, stored } = createMockStore();
-    const llm = {
-      async synthesizeClusterInsight(): Promise<SynthesisVerdict> { return { status: "abstained" }; },
-      async synthesizeClusterPattern(): Promise<SynthesisVerdict> { return { status: "abstained" }; },
-    };
-
-    const result = await clusterAndConsolidate({
-      entries: trioEntries(),
-      embedder: createMockEmbedder(),
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      extractPatterns: true,
-      ...trioParams,
-    });
-
-    expect(stored.length).toBe(0);
-    expect(result.insightsGenerated).toBe(0);
-    expect(result.patternsExtracted).toBe(0);
-    expect(result.synthesisAbstained).toBe(2); // insight + pattern 各一次
-    expect(result.synthesisRejected).toBe(0);
-    expect(result.llmFailures).toBe(0); // 弃权不是失败
-    expect(result.clustersConsolidated).toBe(1); // 簇确实处理过
-  });
-
-  it("校验不过的输出不写库，且与弃权分开计数", async () => {
-    const { store, stored } = createMockStore();
-    const llm = {
-      async synthesizeClusterInsight(): Promise<SynthesisVerdict> {
-        return { status: "rejected", reason: "prompt-echo" };
-      },
-      async synthesizeClusterPattern(): Promise<SynthesisVerdict> {
-        return { status: "rejected", reason: "evidence-too-few" };
-      },
-    };
-
-    const result = await clusterAndConsolidate({
-      entries: trioEntries(),
-      embedder: createMockEmbedder(),
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      extractPatterns: true,
-      ...trioParams,
-    });
-
-    expect(stored.length).toBe(0);
-    expect(result.synthesisRejected).toBe(2);
-    expect(result.synthesisAbstained).toBe(0);
-    expect(result.llmFailures).toBe(0); // 拿到回复了，只是不合契约——不是调用失败
-  });
-});
-
-describe("pattern 与 insight 解耦（R5）", () => {
-  it("insight 弃权时 pattern 照常抽取——改前这簇的 pattern 根本不会被执行", async () => {
-    const { store, stored } = createMockStore();
-    const llm = {
-      async synthesizeClusterInsight(): Promise<SynthesisVerdict> { return { status: "abstained" }; },
-      async synthesizeClusterPattern(): Promise<SynthesisVerdict> {
-        return { status: "ok", output: { text: "跨条目结论", evidence: [1, 2] } };
-      },
-    };
-
-    const result = await clusterAndConsolidate({
-      entries: trioEntries(),
-      embedder: createMockEmbedder(),
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      extractPatterns: true,
-      ...trioParams,
-    });
-
-    expect(result.insightsGenerated).toBe(0);
-    expect(result.patternsExtracted).toBe(1);
-    expect(stored.length).toBe(1);
-    expect(stored[0].text).toBe("跨条目结论");
-  });
-
-  it("insight 抛异常时 pattern 仍然跑（两者独立失败）", async () => {
-    const { store } = createMockStore();
-    const llm = {
-      async synthesizeClusterInsight(): Promise<SynthesisVerdict> { throw new Error("Request was aborted."); },
-      async synthesizeClusterPattern(): Promise<SynthesisVerdict> {
-        return { status: "ok", output: { text: "跨条目结论", evidence: [1, 2] } };
-      },
-    };
-
-    const result = await clusterAndConsolidate({
-      entries: trioEntries(),
-      embedder: createMockEmbedder(),
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      extractPatterns: true,
-      ...trioParams,
-    });
-
-    expect(result.llmFailures).toBe(1);
-    expect(result.insightsGenerated).toBe(0);
-    expect(result.patternsExtracted).toBe(1);
-  });
-
-  it("只有 pattern 产出的一轮不算零产出轮次（否则早停会提前触发）", async () => {
-    // 6 个成员分成两簇，insight 全弃权、pattern 全产出。
-    // 若沿用旧判据（没有 insight = 零产出），连续两簇就会触发 diminishing_returns 早停。
-    const entries = [
-      makeEntry({ id: "a1", text: "簇一 A", vector: [0.9, 0.1, 0] }),
-      makeEntry({ id: "a2", text: "簇一 B", vector: [0.88, 0.12, 0] }),
-      makeEntry({ id: "a3", text: "簇一 C", vector: [0.92, 0.08, 0] }),
-      makeEntry({ id: "b1", text: "簇二 A", vector: [0, 0.9, 0.1] }),
-      makeEntry({ id: "b2", text: "簇二 B", vector: [0, 0.88, 0.12] }),
-      makeEntry({ id: "b3", text: "簇二 C", vector: [0, 0.92, 0.08] }),
-    ];
-    const { store } = createMockStore();
-    const llm = {
-      async synthesizeClusterInsight(): Promise<SynthesisVerdict> { return { status: "abstained" }; },
-      async synthesizeClusterPattern(): Promise<SynthesisVerdict> {
-        return { status: "ok", output: { text: "跨条目结论", evidence: [1, 2] } };
-      },
-    };
-
-    const result = await clusterAndConsolidate({
-      entries,
-      embedder: createMockEmbedder(),
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      extractPatterns: true,
-      ...trioParams,
-    });
-
-    expect(result.clustersFound).toBe(2);
-    expect(result.patternsExtracted).toBe(2);
-    expect(result.earlyStop).toBeUndefined();
-  });
-});
-
-describe("派生物的 boundary 层级（补的是「靠 scope 命名侥幸判对」那一刀）", () => {
-  it("insight 与 pattern 都显式落 evidence 层，不靠 scope 名字推断", async () => {
-    const { store, stored } = createMockStore();
-    const llm = createMockLLM(() => "一条结论", () => "一条跨条目结论");
-
-    await clusterAndConsolidate({
-      entries: trioEntries(),
-      embedder: createMockEmbedder(),
-      llm: llm as unknown as LLMClient,
-      store,
-      // 刻意用非 transcript scope：改前这里会静默拿到 durable 权威
-      scope: "project:test",
-      extractPatterns: true,
-      ...trioParams,
-    });
-
-    expect(stored.length).toBe(2);
-    for (const row of stored) {
-      const meta = JSON.parse(row.metadata!) as { boundary?: { layer?: string; authority?: string } };
-      expect(meta.boundary?.layer).toBe("evidence");
-      expect(meta.boundary?.authority).toBe("distillation");
-    }
-  });
-
-  it("检索侧读得到这个 boundary（与 extractBoundaryMetadata 对得上，不是写了个没人认的字段）", async () => {
-    const { store, stored } = createMockStore();
-    const llm = createMockLLM(() => "一条结论");
-
-    await clusterAndConsolidate({
-      entries: trioEntries(),
-      embedder: createMockEmbedder(),
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      ...trioParams,
-    });
-
-    // coerceBoundaryMetadata 对 layer/authority/conflictPolicy 三项都做白名单校验，
-    // 任一项写错就整个返回 null —— 所以这条断言同时验了三项都合法。
-    const boundary = extractBoundaryMetadata(stored[0].metadata);
-    expect(boundary).not.toBeNull();
-    expect(boundary!.layer).toBe("evidence");
-  });
-
-  it("evidence 编号被翻译成真实的源记忆 id 存下来", async () => {
-    const { store, stored } = createMockStore();
-    const llm = {
-      async synthesizeClusterInsight(): Promise<SynthesisVerdict> {
-        return { status: "ok", output: { text: "一条结论", evidence: [1, 3] } };
-      },
-      async synthesizeClusterPattern(): Promise<SynthesisVerdict> { return { status: "abstained" }; },
-    };
-
-    await clusterAndConsolidate({
-      entries: trioEntries(),
-      embedder: createMockEmbedder(),
-      llm: llm as unknown as LLMClient,
-      store,
-      scope: "project:test",
-      ...trioParams,
-    });
-
-    const meta = JSON.parse(stored[0].metadata!) as { evidenceMemories?: string[]; synthesis_contract?: number };
-    expect(meta.evidenceMemories).toEqual(["a", "c"]); // 1-based → 第 1、第 3 个成员
-    expect(meta.synthesis_contract).toBe(SYNTHESIS_CONTRACT_VERSION);
-  });
-});