@zooique/memora 3.0.1 → 5.0.0

package/dist/agent/managers/llmCaller.js

@@ -28,6 +28,15 @@ import { logger } from '../../logging/logger.js';
  * 与 degrade 降级文案同为内联中文常量——非 UI 文案，不进 UIMessages（宿主可覆盖面不膨胀）。
  */
 const TRUNCATION_RECOVERY_HINT = '上一次回复因思考耗尽输出预算被截断，请直接给出结论或工具调用';
+/**
+ * 输入 token 估算偏差告警阈值（P1-2）。
+ *
+ * 实测输入 token ÷ 估算输入 token 超过该比值 → 估算器**显著低估**（高密度文本如代码 / JSON、
+ * 或 tokenizer 密度与 3 字符/token 启发式偏离）。低估的后果：截断判定「没超」而服务端实际超窗
+ * → 请求失败/静默截断。此前 `actualInputTokens` 有采集有透出却**零消费者** = 观测断链；
+ * 本阈值把它接上消费者：超阈即 warn + span 属性（inputTokenEstimateRatio）持久化比值。
+ */
+const INPUT_TOKEN_DRIFT_ALERT_RATIO = 1.5;
 /**
  * 确定当前回合任务类型（多模型路由）：含代码块→code；长文本(>500字符)→reasoning；其余→simple
  *
@@ -177,7 +186,8 @@ export class LlmCaller {
             try {
                 attemptsMade++;
                 metrics.llmCallCount++;
-                metrics.totalInputTokens += contextManager.estimateTokens(safeMessages);
+                const estimatedInputTokens = contextManager.estimateTokens(safeMessages);
+                metrics.totalInputTokens += estimatedInputTokens;
                 // 截断型换策略（双轨，方案 T2）：①降推理深度已在下方 empty 分支随 truncatedRetry 置入
                 // effectiveOpts.reasoning_effort='low'（复用 multiStepReasoning='manual' 既有转达通道，
                 // provider 支持才生效）；②纠正提示注入消息尾（提示保底——reasoning_effort 被中转无视
@@ -187,6 +197,8 @@ export class LlmCaller {
                 if (truncatedRetry) {
                     requestMessages.push({ role: 'system', content: TRUNCATION_RECOVERY_HINT });
                 }
+                // P1-2：估算/实测偏差告警（每次调用至多一次，防多 chunk 重复刷屏）
+                let inputDriftWarned = false;
                 for await (const chunk of effectiveProvider.chat(requestMessages, effectiveOpts)) {
                     streamStarted = true;
                     if (signal?.aborted) {
@@ -199,6 +211,20 @@ export class LlmCaller {
                         metrics.actualOutputTokens += chunk.usage.outputTokens;
                         llmSpan.setAttribute('actualInputTokens', chunk.usage.inputTokens);
                         llmSpan.setAttribute('actualOutputTokens', chunk.usage.outputTokens);
+                        // P1-2：实测输入 token 相对估算的偏差告警（低估方向超阈即报，接通 actualInputTokens 消费者）
+                        if (!inputDriftWarned && estimatedInputTokens > 0 && chunk.usage.inputTokens > 0) {
+                            inputDriftWarned = true;
+                            const ratio = chunk.usage.inputTokens / estimatedInputTokens;
+                            llmSpan.setAttribute('inputTokenEstimateRatio', ratio);
+                            if (ratio > INPUT_TOKEN_DRIFT_ALERT_RATIO) {
+                                logger.warn({
+                                    estimatedInputTokens,
+                                    actualInputTokens: chunk.usage.inputTokens,
+                                    ratio,
+                                }, '输入 token 估算显著低估（实测 > 估算 × 阈值）：估算器对高密度文本可能失准，' +
+                                    '截断判定或将滞后（判定未超而实际超窗）');
+                            }
+                        }
                     }
                     // 诊断证据采集（末次口径）：finish_reason 随尾 chunk 回传（末条覆盖为准），
                     // thinking 字符数按增量累计——空响应分型（截断/瞬态）的裁决依据

package/dist/agent/managers/llmCaller.js.map

@@ -1 +1 @@
-{"version":3,"file":"llmCaller.js","sourceRoot":"","sources":["../../../src/agent/managers/llmCaller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"llmCaller.js","sourceRoot":"","sources":["../../../src/agent/managers/llmCaller.ts"],"names":[],"mappings":"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"}

package/dist/agent/managers/loopMetrics.d.ts

@@ -54,5 +54,19 @@ export declare class LoopMetrics {
      *  与 ledgerStubEchoCount 互补：本计数 = L2 精确判重（模型乒乓信号，撞墙升级文案的量化基线），
      *  后者 = L3 变体顶替；健康态应接近 0，持续增长 = 模型在同主体上反复重读。 */
     readDedupBlockCount: number;
+    /**
+     * 主动挡下总数（loop 护栏 + 旁路拒绝 + 台账替身 + 执行层闸门）。
+     *
+     * **B4 口径（Breaking，CHANGELOG 已登记）**：执行层闸门（`permission_denied` /
+     * `readonly_denied` / `idempotent_skip`）从 `toolFailureCount` 剔除、归入本计数
+     * ⇒ 失败数下降、挡下数上升，历史不可比。
+     */
+    toolBlockedCount: number;
+    /**
+     * 主动挡下中「背后藏真失败」的次数（当前唯一子集 = `read_failed` 护栏）。
+     * 独立于 `toolFailureCount`：它是 blocked 的子集，混入失败总数会让
+     * 「主动停手」与「真失败」共用一个数字（见方案 §六决策一）。
+     */
+    toolBlockedWithFailureCount: number;
 }
 //# sourceMappingURL=loopMetrics.d.ts.map

package/dist/agent/managers/loopMetrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loopMetrics.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/loopMetrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,YAAY,SAAK;IACjB,gBAAgB,SAAK;IACrB,iBAAiB,SAAK;IACtB,iBAAiB,SAAK;IACtB,kBAAkB,SAAK;IACvB,aAAa,SAAK;IAClB,gBAAgB,SAAK;IAErB;2DACuD;IACvD,kBAAkB,SAAK;IAEvB;;uDAEmD;IACnD,uBAAuB,SAAK;IAG5B;;;;OAIG;IACH,uBAAuB,SAAK;IAG5B,uCAAuC;IACvC,cAAc,SAAK;IACnB,aAAa;IACb,gBAAgB,SAAK;IACrB,4BAA4B;IAC5B,gBAAgB,SAAK;IACrB,0BAA0B;IAC1B,mBAAmB,SAAK;IAExB,iBAAiB;IACjB,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,iBAAiB;IACjB,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAGD,6CAA6C;IAC7C,uBAAuB,SAAK;IAC5B,+CAA+C;IAC/C,qBAAqB,SAAK;IAG1B;yEACqE;IACrE,oBAAoB,SAAK;IAGzB;sEACkE;IAClE,mBAAmB,SAAK;IAGxB;;oDAEgD;IAChD,mBAAmB,SAAK;CACzB"}
+{"version":3,"file":"loopMetrics.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/loopMetrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,YAAY,SAAK;IACjB,gBAAgB,SAAK;IACrB,iBAAiB,SAAK;IACtB,iBAAiB,SAAK;IACtB,kBAAkB,SAAK;IACvB,aAAa,SAAK;IAClB,gBAAgB,SAAK;IAErB;2DACuD;IACvD,kBAAkB,SAAK;IAEvB;;uDAEmD;IACnD,uBAAuB,SAAK;IAG5B;;;;OAIG;IACH,uBAAuB,SAAK;IAG5B,uCAAuC;IACvC,cAAc,SAAK;IACnB,aAAa;IACb,gBAAgB,SAAK;IACrB,4BAA4B;IAC5B,gBAAgB,SAAK;IACrB,0BAA0B;IAC1B,mBAAmB,SAAK;IAExB,iBAAiB;IACjB,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,iBAAiB;IACjB,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAGD,6CAA6C;IAC7C,uBAAuB,SAAK;IAC5B,+CAA+C;IAC/C,qBAAqB,SAAK;IAG1B;yEACqE;IACrE,oBAAoB,SAAK;IAGzB;sEACkE;IAClE,mBAAmB,SAAK;IAGxB;;oDAEgD;IAChD,mBAAmB,SAAK;IAGxB;;;;;;OAMG;IACH,gBAAgB,SAAK;IAErB;;;;OAIG;IACH,2BAA2B,SAAK;CACjC"}

package/dist/agent/managers/loopMetrics.js

@@ -64,5 +64,20 @@ export class LoopMetrics {
      *  与 ledgerStubEchoCount 互补：本计数 = L2 精确判重（模型乒乓信号，撞墙升级文案的量化基线），
      *  后者 = L3 变体顶替；健康态应接近 0，持续增长 = 模型在同主体上反复重读。 */
     readDedupBlockCount = 0;
+    // ─── SCRIPT-2 主动挡下计数（B4 口径收口）──
+    /**
+     * 主动挡下总数（loop 护栏 + 旁路拒绝 + 台账替身 + 执行层闸门）。
+     *
+     * **B4 口径（Breaking，CHANGELOG 已登记）**：执行层闸门（`permission_denied` /
+     * `readonly_denied` / `idempotent_skip`）从 `toolFailureCount` 剔除、归入本计数
+     * ⇒ 失败数下降、挡下数上升，历史不可比。
+     */
+    toolBlockedCount = 0;
+    /**
+     * 主动挡下中「背后藏真失败」的次数（当前唯一子集 = `read_failed` 护栏）。
+     * 独立于 `toolFailureCount`：它是 blocked 的子集，混入失败总数会让
+     * 「主动停手」与「真失败」共用一个数字（见方案 §六决策一）。
+     */
+    toolBlockedWithFailureCount = 0;
 }
 //# sourceMappingURL=loopMetrics.js.map

package/dist/agent/managers/loopMetrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"loopMetrics.js","sourceRoot":"","sources":["../../../src/agent/managers/loopMetrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAW;IACtB,YAAY,GAAG,CAAC,CAAC;IACjB,gBAAgB,GAAG,CAAC,CAAC;IACrB,iBAAiB,GAAG,CAAC,CAAC;IACtB,iBAAiB,GAAG,CAAC,CAAC;IACtB,kBAAkB,GAAG,CAAC,CAAC;IACvB,aAAa,GAAG,CAAC,CAAC;IAClB,gBAAgB,GAAG,CAAC,CAAC;IAErB;2DACuD;IACvD,kBAAkB,GAAG,CAAC,CAAC;IAEvB;;uDAEmD;IACnD,uBAAuB,GAAG,CAAC,CAAC;IAE5B,qCAAqC;IACrC;;;;OAIG;IACH,uBAAuB,GAAG,CAAC,CAAC;IAE5B,wCAAwC;IACxC,uCAAuC;IACvC,cAAc,GAAG,CAAC,CAAC;IACnB,aAAa;IACb,gBAAgB,GAAG,CAAC,CAAC;IACrB,4BAA4B;IAC5B,gBAAgB,GAAG,CAAC,CAAC;IACrB,0BAA0B;IAC1B,mBAAmB,GAAG,CAAC,CAAC;IAExB,iBAAiB;IACjB,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,iBAAiB;IACjB,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;IAED,mCAAmC;IACnC,6CAA6C;IAC7C,uBAAuB,GAAG,CAAC,CAAC;IAC5B,+CAA+C;IAC/C,qBAAqB,GAAG,CAAC,CAAC;IAE1B,iCAAiC;IACjC;yEACqE;IACrE,oBAAoB,GAAG,CAAC,CAAC;IAEzB,sCAAsC;IACtC;sEACkE;IAClE,mBAAmB,GAAG,CAAC,CAAC;IAExB,uBAAuB;IACvB;;oDAEgD;IAChD,mBAAmB,GAAG,CAAC,CAAC;CACzB"}
+{"version":3,"file":"loopMetrics.js","sourceRoot":"","sources":["../../../src/agent/managers/loopMetrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAW;IACtB,YAAY,GAAG,CAAC,CAAC;IACjB,gBAAgB,GAAG,CAAC,CAAC;IACrB,iBAAiB,GAAG,CAAC,CAAC;IACtB,iBAAiB,GAAG,CAAC,CAAC;IACtB,kBAAkB,GAAG,CAAC,CAAC;IACvB,aAAa,GAAG,CAAC,CAAC;IAClB,gBAAgB,GAAG,CAAC,CAAC;IAErB;2DACuD;IACvD,kBAAkB,GAAG,CAAC,CAAC;IAEvB;;uDAEmD;IACnD,uBAAuB,GAAG,CAAC,CAAC;IAE5B,qCAAqC;IACrC;;;;OAIG;IACH,uBAAuB,GAAG,CAAC,CAAC;IAE5B,wCAAwC;IACxC,uCAAuC;IACvC,cAAc,GAAG,CAAC,CAAC;IACnB,aAAa;IACb,gBAAgB,GAAG,CAAC,CAAC;IACrB,4BAA4B;IAC5B,gBAAgB,GAAG,CAAC,CAAC;IACrB,0BAA0B;IAC1B,mBAAmB,GAAG,CAAC,CAAC;IAExB,iBAAiB;IACjB,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,iBAAiB;IACjB,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;IAED,mCAAmC;IACnC,6CAA6C;IAC7C,uBAAuB,GAAG,CAAC,CAAC;IAC5B,+CAA+C;IAC/C,qBAAqB,GAAG,CAAC,CAAC;IAE1B,iCAAiC;IACjC;yEACqE;IACrE,oBAAoB,GAAG,CAAC,CAAC;IAEzB,sCAAsC;IACtC;sEACkE;IAClE,mBAAmB,GAAG,CAAC,CAAC;IAExB,uBAAuB;IACvB;;oDAEgD;IAChD,mBAAmB,GAAG,CAAC,CAAC;IAExB,iCAAiC;IACjC;;;;;;OAMG;IACH,gBAAgB,GAAG,CAAC,CAAC;IAErB;;;;OAIG;IACH,2BAA2B,GAAG,CAAC,CAAC;CACjC"}

package/dist/agent/managers/memoryInspector.d.ts

@@ -1,7 +1,9 @@
 /**
  * 记忆管理器 — 统一的记忆读写入口。
  * 写方法 writeXxx 前缀区分写操作。同步返回避免数据不一致；每层只返回前 N 条 + 总数（轻量）。
- * 职责边界：本类只做存储读写与查询；语义去重在 DedupManager，冲突检测/建议在 MemoryAdvisor。
+ * 职责边界：本类只做存储读写与查询。**记忆的写时治理**（supersede 取代判定）不在此——
+ * 它在 `roundSummaryGenerator` 的写入路径上。曾有「语义去重归 DedupManager、冲突检测/建议归
+ * MemoryAdvisor」的分工，二者已随 GOVERNANCE-SRC-1（2026-10-18）整链退役，勿按旧注释查找。
  */
 import type { Memory } from '../../memory/types.js';
 import type { IMemoryStorage } from '../../memory/storageInterface.js';
@@ -78,7 +80,8 @@ export declare class MemoryInspector {
     private readonly loop;
     private readonly history;
     /**
-     * 构造记忆管理器。sourceHealth/suggest 由 Agent 门面直连 MemoryAdvisor，本类不持有 advisor（消除 3 层代理）。
+     * 构造记忆管理器。本类不持有任何 advisor——原 `sourceHealth` / `suggest` 曾由 Agent 门面直连
+     * `MemoryAdvisor`（消除 3 层代理），该类已随 GOVERNANCE-SRC-1（2026-10-18）整链退役。
      */
     constructor(index: IMemoryStorage, loop: AgentLoop, history: MessageHistory);
     /** 列出回收站软删除记忆。limit<=0 或 undefined 表示不设上限，否则返回最近 N 条（默认 undefined=全部）。 */
@@ -91,20 +94,13 @@ export declare class MemoryInspector {
     getBySource(source: string): Memory[];
     /**
      * 列出活跃记忆（供宿主记忆管理面板），按 accessedAt 降序。
-     * search() 拒绝空查询防"静默全量返回"误用；list() 是显式声明列举——但**默认仍带 50 条上限**
+     * searchByKeyword() 拒绝空查询防"静默全量返回"误用；list() 是显式声明列举——但**默认仍带 50 条上限**
      * （安全默认，与 listDeleted 的 undefined=全部 语义刻意不同）。需要全量的调用方须
      * 显式传入上限（如 stats().total），否则静默截断。
      */
     list(limit?: number): Memory[];
     /** 统一查看记忆快照（3 层）：纯只读、同步返回、每层只返回前 N 条 + 总数。 */
     snapshot(): MemorySnapshot;
-    /**
-     * @deprecated 本同步通道已退役，功能由 `searchByKeyword()` 承担（后者含
-     * superseded 过滤 / excludeRoundIds 互斥 / accessedAt + 溯源揭示）。当前无生产/宿主消费方，
-     * 勿新增调用。
-     * 搜索记忆（关键词 + FTS5 索引），返回 CLI 友好扁平结构（已截断）。
-     */
-    search(query: string, limit?: number): AgentSearchHit[];
     /**
      * 搜索记忆（纯关键词单通道，无向量通道、无融合排序）。
      *
@@ -113,10 +109,12 @@ export declare class MemoryInspector {
      * 分层分轨原属「召回编排」`recall()`；**现行实现中已无任何召回编排**，
      * 搜索工具只暴露过滤后的结果，供宿主/上层按需自取（见 memory-as-summary §4.5 边界标注）。
      *
-     * 无语义（向量）通道：embedding 写端缺失导致语义通道在生产从未生效，
-     * 属于「宣称能力零消费」的僵尸；且主流 agent（Anthropic Memory tool / Claude Code / Librarian Pattern）
-     * 已实证「LLM 消费者 + 小语料」下纯关键词足用——LLM 会自主改述重试（工具描述已提示）。向量语义检索
-     * 的 cache 形态方案记入探索期文档候选，等真实「关键词搜不到」复现再按缓存重算形态补回。
+     * 无语义（向量）通道：embedding 写端从未接通，语义通道生产从未生效，已随 B0 收编整体移除
+     * （vectorStore / embedding 配置段全删），工具描述亦已明文否认——此处仅存「为何无向量通道」的
+     * 历史说明，非现行能力宣称。设计依据：主流 agent（Anthropic Memory tool / Claude Code /
+     * Librarian Pattern）已实证「LLM 消费者 + 小语料」下纯关键词足用，LLM 会自主改述重试（工具
+     * 描述已提示）。cache-recompute 形态为预留补回位（见 memory-as-summary §4.5），等真实
+     * 「关键词搜不到」复现再按缓存重算形态补回。
      *
      * @param excludeRoundIds 排除的轮次 ID 集合（可选）：这些轮次的 round-summary 已被装配期载入正文，
      *                       不重复返回（工具召回与装配期正文互斥，§5.1）；缺省不过滤。
@@ -147,7 +145,7 @@ export declare class MemoryInspector {
      * 宿主经 IPC 同步消费——无 fire-and-forget/catch 可言，注释按事实陈述。
      */
     writePurge(id: string): void;
-    /** 清理 deletedAt 早于 before 的软删除记忆（宿主定时器调用，默认 30 天保留期） */
+    /** 清理 deletedAt 早于 before 的软删除记忆（宿主入口显式调用；保留期归宿主策略，当前默认 30 天） */
     writePurgeExpired(before: Date): number;
 }
 //# sourceMappingURL=memoryInspector.d.ts.map

package/dist/agent/managers/memoryInspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memoryInspector.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/memoryInspector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAejD,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,yBAAyB;IACzB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,gCAAgC;IAChC,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,mBAAmB;AACnB,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;QAC/C,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;CACJ;AAED,2BAA2B;AAC3B,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,kBAAkB;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;CACJ;AAED,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,KAAK,EAAE;QACL,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,cAAc;AACd,MAAM,WAAW,UAAU;IACzB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAID,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B;;OAEG;gBAEgB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,cAAc;IAK1C,0EAA0E;IAC1E,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAIrC,wDAAwD;IACxD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIzC,kCAAkC;IAClC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIlC,sDAAsD;IACtD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAIrC;;;;;OAKG;IACH,IAAI,CAAC,KAAK,SAAK,GAAG,MAAM,EAAE;IAM1B,8CAA8C;IAC9C,QAAQ,IAAI,cAAc;IA0C1B;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,cAAc,EAAE;IAwBnD;;;;;;;;;;;;;;;OAeG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,EACV,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACpC,OAAO,CAAC,cAAc,EAAE,CAAC;IA+C5B,qEAAqE;IACrE,KAAK,IAAI,UAAU;IAcnB,cAAc;IACd,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIjC,0BAA0B;IAC1B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI7B;;;;;;;;;;OAUG;IACH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAepD,4BAA4B;IAC5B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI9B;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,wDAAwD;IACxD,iBAAiB,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM;CAGxC"}
+{"version":3,"file":"memoryInspector.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/memoryInspector.ts"],"names":[],"mappings":"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"}

package/dist/agent/managers/memoryInspector.js

@@ -1,4 +1,6 @@
 import { SOURCE_LABELS } from '../../memory/types.js';
+import { hasActiveSuperseder } from '../../memory/supersedeResolve.js';
+import { findRoundSummaries } from '../../memory/roundSummaryLookup.js';
 import { configError } from '../../utils/errors.js';
 import { truncate } from '../../utils/strings.js';
 // ─── 常量 ────────────────────────────────────────────────
@@ -14,7 +16,8 @@ export class MemoryInspector {
     loop;
     history;
     /**
-     * 构造记忆管理器。sourceHealth/suggest 由 Agent 门面直连 MemoryAdvisor，本类不持有 advisor（消除 3 层代理）。
+     * 构造记忆管理器。本类不持有任何 advisor——原 `sourceHealth` / `suggest` 曾由 Agent 门面直连
+     * `MemoryAdvisor`（消除 3 层代理），该类已随 GOVERNANCE-SRC-1（2026-10-18）整链退役。
      */
     constructor(index, loop, history) {
         this.index = index;
@@ -40,7 +43,7 @@ export class MemoryInspector {
     }
     /**
      * 列出活跃记忆（供宿主记忆管理面板），按 accessedAt 降序。
-     * search() 拒绝空查询防"静默全量返回"误用；list() 是显式声明列举——但**默认仍带 50 条上限**
+     * searchByKeyword() 拒绝空查询防"静默全量返回"误用；list() 是显式声明列举——但**默认仍带 50 条上限**
      * （安全默认，与 listDeleted 的 undefined=全部 语义刻意不同）。需要全量的调用方须
      * 显式传入上限（如 stats().total），否则静默截断。
      */
@@ -84,35 +87,11 @@ export class MemoryInspector {
         };
     }
     // ─── 搜索 ─────────────────────────────────────────────
-    /**
-     * @deprecated 本同步通道已退役，功能由 `searchByKeyword()` 承担（后者含
-     * superseded 过滤 / excludeRoundIds 互斥 / accessedAt + 溯源揭示）。当前无生产/宿主消费方，
-     * 勿新增调用。
-     * 搜索记忆（关键词 + FTS5 索引），返回 CLI 友好扁平结构（已截断）。
-     */
-    search(query, limit = 10) {
-        // 空 query 会让 search() 退化为"返回所有"，对宿主程序是静默误导
-        if (!query || query.trim() === '') {
-            throw configError('搜索关键词为空', 'search() 需要非空 query', [
-                '传入非空字符串关键词',
-                '使用 snapshot().bootstrap.items 列出所有引导记忆',
-            ]);
-        }
-        if (limit <= 0 || !Number.isInteger(limit)) {
-            throw configError('无效 limit', `limit 必须是正整数，收到 ${limit}`, [
-                '使用 limit = 10（默认值）',
-            ]);
-        }
-        const hits = this.index.search(query, limit);
-        return hits.map((m) => ({
-            id: m.id,
-            name: m.name,
-            source: m.source,
-            // 截断长内容到搜索预览长度
-            contentPreview: truncate(m.content, SEARCH_PREVIEW_LEN),
-            createdAt: m.createdAt,
-        }));
-    }
+    // ⚠️ 原 `search()`（同步关键词搜索）已于 **4.0.0 移除**：被下方 `searchByKeyword()` 完全取代
+    // （后者含 superseded 过滤 / excludeRoundIds 互斥 / accessedAt 刷新 + 溯源揭示），
+    // 移除前已实测零生产消费、零宿主消费（宿主只调 `searchByKeyword`）。
+    // 旧版它标 `@deprecated` 却仍列在随包 API 文档里当正常方法——属「退役不彻底」的僵尸出口，
+    // 在 major 版本一并清掉。勿按旧文档找回该入口，一律用 `searchByKeyword()`。
     /**
      * 搜索记忆（纯关键词单通道，无向量通道、无融合排序）。
      *
@@ -121,10 +100,12 @@ export class MemoryInspector {
      * 分层分轨原属「召回编排」`recall()`；**现行实现中已无任何召回编排**，
      * 搜索工具只暴露过滤后的结果，供宿主/上层按需自取（见 memory-as-summary §4.5 边界标注）。
      *
-     * 无语义（向量）通道：embedding 写端缺失导致语义通道在生产从未生效，
-     * 属于「宣称能力零消费」的僵尸；且主流 agent（Anthropic Memory tool / Claude Code / Librarian Pattern）
-     * 已实证「LLM 消费者 + 小语料」下纯关键词足用——LLM 会自主改述重试（工具描述已提示）。向量语义检索
-     * 的 cache 形态方案记入探索期文档候选，等真实「关键词搜不到」复现再按缓存重算形态补回。
+     * 无语义（向量）通道：embedding 写端从未接通，语义通道生产从未生效，已随 B0 收编整体移除
+     * （vectorStore / embedding 配置段全删），工具描述亦已明文否认——此处仅存「为何无向量通道」的
+     * 历史说明，非现行能力宣称。设计依据：主流 agent（Anthropic Memory tool / Claude Code /
+     * Librarian Pattern）已实证「LLM 消费者 + 小语料」下纯关键词足用，LLM 会自主改述重试（工具
+     * 描述已提示）。cache-recompute 形态为预留补回位（见 memory-as-summary §4.5），等真实
+     * 「关键词搜不到」复现再按缓存重算形态补回。
      *
      * @param excludeRoundIds 排除的轮次 ID 集合（可选）：这些轮次的 round-summary 已被装配期载入正文，
      *                       不重复返回（工具召回与装配期正文互斥，§5.1）；缺省不过滤。
@@ -140,11 +121,15 @@ export class MemoryInspector {
                 '使用 limit = 10（默认值）',
             ]);
         }
-        // 单个通道：纯关键词搜索（无向量通道、无融合排序，FTS 索引已按相关性返回）
+        // 单个通道：纯关键词搜索（无向量通道、无融合排序、**无 FTS 索引**）——顺序由存储层
+        // 按 `accessedAt` 倒序给出（§5.2 2026-10-19 改定案：承认时间主序），命中本身不产生次序。
         const keywordResults = this.index.search(query, limit);
-        // 前置 superseded 过滤：被 supersededBy 取代的摘要不作为当前事实
-        // 返回（仍保留可回溯，trace_summary 可精确取原文）。在截断前过滤，避免占据 top-N 槽位挤掉有效命中。
-        const active = keywordResults.filter((m) => !m.supersededBy);
+        // 前置 superseded 过滤：被「现存且活跃」摘要取代的摘要不作为当前事实返回
+        // （仍保留可回溯，trace_summary 可精确取原文）；悬空指针（替代物已移除/软删）视为未取代，
+        // 旧摘要回退为当前版本——判据见 supersedeResolve.hasActiveSuperseder。
+        // 本过滤在 index.search 取回 top-limit 之后执行、被取代者不补位——已知边界：被取代条目
+        // 占槽位时返回可能少于 limit（不扩量重查；与 excludeRoundIds 的「不补位」同形态）。
+        const active = keywordResults.filter((m) => !hasActiveSuperseder(m, this.index));
         // 工具召回与装配期内容互斥（§5.1）：排除「正文或摘要已在眼前」轮次的 round-summary，
         // 避免 LLM 拿回眼前内容的摘要重复（excludeRoundIds 由调用方按 loop.getExclusionRoundIds 精确派生，
         // = 视图内 ∪ 被替换 ∪ 在途，天然不含当轮）。
@@ -152,8 +137,9 @@ export class MemoryInspector {
         const unexcluded = excludeRoundIds && excludeRoundIds.size > 0
             ? active.filter((m) => !m.roundId || !excludeRoundIds.has(m.roundId))
             : active;
-        // 截断到 limit；不引入 accessedAt 时间主序（§5.2 定案）——
-        // accessedAt 只作为事实字段揭示（工具命中 touch 刷新），优先级判断归 LLM 结合任务定夺。
+        // 截断到 limit。排序**不由本层再动**：存储层已按 accessedAt 倒序（§5.2 2026-10-19 改定案），
+        // 本层只做过滤与截断，不重排/不分档（重排会造第二种次序判据）。accessedAt 同时随命中项
+        // 作为事实字段揭示（工具命中 touch 刷新），供 LLM 判断新鲜度。
         const result = unexcluded.slice(0, limit);
         return result.map((memory) => ({
             id: memory.id,
@@ -206,15 +192,18 @@ export class MemoryInspector {
         if (roundIds.length === 0)
             return 0;
         const idSet = new Set(roundIds);
+        // 寻址单源：与 GC 的 cleanUpRoundSummary 共用同一选择集（roundSummaryLookup），
+        // 分叉仅在处置动作（软删+脱钩 vs 物理 purge，见 memory-as-summary.md §5.1）
+        const roundSummaries = findRoundSummaries(this.index, idSet);
         let count = 0;
-        for (const memory of this.index.getBySource(SOURCE_LABELS.ROUND_SUMMARY)) {
-            if (memory.roundId && idSet.has(memory.roundId)) {
-                // 脱钩溯源（覆盖写为无溯源副本，仅清除顶层字段不动内容/权重）→ 软删进回收站
-                this.index.upsert({ ...memory, sessionName: undefined, roundId: undefined });
-                this.index.delete(memory.id);
-                count++;
-            }
+        for (const memory of roundSummaries) {
+            // 脱钩溯源（覆盖写为无溯源副本，仅清除顶层字段不动内容/权重）→ 软删进回收站
+            this.index.upsert({ ...memory, sessionName: undefined, roundId: undefined });
+            this.index.delete(memory.id);
+            count++;
         }
+        // 无需在此收敛悬空取代指针：消费侧 hasActiveSuperseder 把悬空指针视为未取代，
+        // 被移除替代物的旧摘要自动回退为当前版本（见 supersedeResolve.ts），与移除路径解耦。
         return count;
     }
     /** 恢复软删除记忆（清除 deletedAt） */
@@ -228,7 +217,7 @@ export class MemoryInspector {
     writePurge(id) {
         this.index.purge(id);
     }
-    /** 清理 deletedAt 早于 before 的软删除记忆（宿主定时器调用，默认 30 天保留期） */
+    /** 清理 deletedAt 早于 before 的软删除记忆（宿主入口显式调用；保留期归宿主策略，当前默认 30 天） */
     writePurgeExpired(before) {
         return this.index.purgeExpired(before);
     }

package/dist/agent/managers/memoryInspector.js.map

@@ -1 +1 @@
-{"version":3,"file":"memoryInspector.js","sourceRoot":"","sources":["../../../src/agent/managers/memoryInspector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memoryInspector.js","sourceRoot":"","sources":["../../../src/agent/managers/memoryInspector.ts"],"names":[],"mappings":"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"}

package/dist/agent/managers/roundSummaryGenerator.d.ts

@@ -5,6 +5,18 @@
  */
 import type { LlmProvider } from '../../llm/provider.js';
 import type { IMemoryStorage } from '../../memory/storageInterface.js';
+/**
+ * 计算摘要原料指纹：sha256(输入原文 + NUL + 助手回复原文)。
+ *
+ * 取原文全文（非截断值）：截断面内相同、截断面外不同 → 严格不等 → 放行生成
+ * （宁可放行一条轻微重复，不误杀——判据取严，仅铁重复时跳过）。
+ * 摘要生成器只吃这两个原料（上下文差异最终体现为回复差异），故原料全等 ⇒ 摘要无增量。
+ *
+ * @param input 用户输入原文（不截断）
+ * @param assistantContent 助手回复原文（不截断）
+ * @returns 64 位 hex 指纹
+ */
+export declare function materialFingerprint(input: string, assistantContent: string): string;
 /** 轮次摘要生成器：在 Agent.postProcess 中调用，LlmProvider 生成摘要 + IMemoryStorage 持久化。 */
 export declare class RoundSummaryGenerator {
     private readonly storage;
@@ -15,19 +27,37 @@ export declare class RoundSummaryGenerator {
     constructor(provider: LlmProvider, storage: IMemoryStorage);
     /** 注入后台 Provider（Agent.setBackgroundProvider 调用）；null 表示回退到默认 Provider */
     setBackgroundProvider(provider: LlmProvider | null): void;
-    /** 记忆写入回调（memoryAdded 事件出口）：摘要即记忆，新摘要写入后通知宿主「已沉淀」 */
+    /** 记忆写入回调（memoryAdded 事件出口）：摘要即记忆，新摘要写入后通知宿主「已沉淀」。
+     * content = 记忆正文（宿主提示按用户心智显示内容，回退 name） */
     private _onMemoryAdded;
     /** 绑定记忆写入回调（Agent.init 调用）；传 null 解除绑定 */
     setOnMemoryAdded(fn: ((info: {
         id: string;
         source: string;
         name: string;
+        content: string;
     }) => void) | null): void;
     /**
      * 生成并持久化轮次摘要。异步 fire-and-forget，内部捕获异常，仅记警告不阻塞主对话流程。
+     *
+     * 写入前三态（P1-5a，各态日志可区分，杜绝静默跳过）：
+     *   ① 原料指纹全等（重复轮）→ 跳过，不调 LLM；② LLM 判 summary=null（不值得记）→ 不写入；
+     *   ③ 正常沉淀 → upsert + memoryAdded 事件。②③ 之外事件链照走（宿主解锁不依赖写入与否）。
+     *
      * @param focus 角色包提炼视角（prepare.summaryFocus，undefined=通用浓缩）；存在时以其视角替换「值得记什么」判断主体，JSON 契约固定保留。
      */
     generate(input: string, assistantContent: string, roundId: string, sessionName: string, focus?: string): Promise<void>;
+    /**
+     * 前置精确去重判定：存量 round-summary 中是否已有原料指纹全等的条目。
+     *
+     * 全库比对（不限 session）：精确重复无跨会话例外——同原料在哪个会话产生同一份摘要，
+     * 与语义近似取代（supersedeSimilar，刻意仅同 session）是两套判据，勿混。
+     * 软删条目经 getBySource 被过滤（活跃面才挡），用户已删的不复活也不拦新轮。
+     *
+     * @param fingerprint 本轮原料指纹
+     * @returns true = 存量已有全等原料摘要，本轮应跳过
+     */
+    private isDuplicateMaterial;
     /**
      * 构造取代检测候选：同 session 且未被取代的摘要，按时间倒序取最近 N 条（SUPERSEDE_CANDIDATE_WINDOW）。
      * 取代语义是"本 session 内新决策替换旧同主题决策"——收敛到同 session 近期摘要，

package/dist/agent/managers/roundSummaryGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roundSummaryGenerator.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/roundSummaryGenerator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,mBAAmB,CAAC;AAS9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAwEnE,6EAA6E;AAC7E,qBAAa,qBAAqB;IAQ9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAc;IAC9B,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAc;gBAG5C,QAAQ,EAAE,WAAW,EACJ,OAAO,EAAE,cAAc;IAM1C,0EAA0E;IAC1E,qBAAqB,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAIzD,qDAAqD;IACrD,OAAO,CAAC,cAAc,CACf;IAEP,0CAA0C;IAC1C,gBAAgB,CACd,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,GACxE,IAAI;IAIP;;;OAGG;IACG,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAmDhB;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,gBAAgB;CA0BzB"}
+{"version":3,"file":"roundSummaryGenerator.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/roundSummaryGenerator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,mBAAmB,CAAC;AAU9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAmCnE;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAEnF;AAqDD,6EAA6E;AAC7E,qBAAa,qBAAqB;IAQ9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAc;IAC9B,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAc;gBAG5C,QAAQ,EAAE,WAAW,EACJ,OAAO,EAAE,cAAc;IAM1C,0EAA0E;IAC1E,qBAAqB,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAIzD;+CAC2C;IAC3C,OAAO,CAAC,cAAc,CAC0E;IAEhG,0CAA0C;IAC1C,gBAAgB,CACd,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,GACzF,IAAI;IAIP;;;;;;;;OAQG;IACG,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IA6EhB;;;;;;;;;OASG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,gBAAgB;CA0BzB"}