@zooique/memora 1.0.1 → 2.0.3

package/dist/agent/managers/memoryDecayScheduler.js

@@ -6,6 +6,7 @@
  *   2. 衰减指标统计（执行次数 / 累计衰减记忆数 / 上次衰减时间）
  *   3. 衰减可观测性（Tracer Span 埋点）
  *   4. 衰减完成事件发射（decayCompleted）
+ *   5. L2 时效性评估（可选，backgroundProvider + index 注入后启用）
  *
  * 设计理由：
  *   agent.ts 原承担 15+ 职责，记忆衰减是独立的生命周期职责，
@@ -17,6 +18,12 @@
  *   - work-projection（作品投影）
  *   不衰减 persona/rule/skill（配置型记忆不应衰减）
  *
+ * L2 时效性评估（可选增强）：
+ *   - 衰减后扫描低分记忆（score < TIMELINESS_LOW_SCORE_THRESHOLD）
+ *   - 调用 LLM 判断是否"已过时"（如过时的技术栈、已变更的偏好）
+ *   - 过时则进一步降级（score → TIMELINESS_OUTDATED_SCORE）
+ *   - backgroundProvider / index 未注入时静默跳过（向后兼容）
+ *
  * 自然生长原则：
  *   - 不持有 storage 引用（start 时注入，stop 时释放）
  *   - 通过回调发射事件（不继承 TypedEventEmitter，避免与 Agent 事件系统耦合）
@@ -26,8 +33,24 @@ import { safeSetInterval, clearSafeInterval } from '../../utils/safeTimer.js';
 import { logger } from '../../logging/logger.js';
 import { toError } from '../../utils/errors.js';
 import { nowIso } from '../../utils/time.js';
-import { SOURCE_LABELS } from '../../memory/types.js';
 import { NOOP_TRACER, TRACE_SPANS } from '../../agent/tracer.js';
+// LLM judge 三件套高阶函数（流式累积 + parseLlmJson + configError 异常封装）
+import { judgeWithLlm } from '../../agent/managers/llmJudgeHelper.js';
+import { truncate } from '../../utils/strings.js';
+// LLM 治理源列表（v2 REPEAT-1 闭环，消除 5 处独立维护的 [INSIGHT, PROFILE, WORK_PROJECTION] 列表）
+import { GOVERNANCE_SOURCES } from '../../memory/governance.js';
+// ─── L2 时效性评估常量 ────────────────────────────────────
+// 注：TIMELINESS_SOURCES 已统一为 GOVERNANCE_SOURCES（governance.ts），消除 5 处独立维护
+/** 低分记忆阈值（score 低于此值的记忆进入 LLM 时效性评估） */
+const TIMELINESS_LOW_SCORE_THRESHOLD = 0.3;
+/** 单次时效性评估的记忆条数上限（控制 LLM 调用量） */
+const TIMELINESS_EVALUATE_LIMIT = 20;
+/** LLM 时效性判断超时（ms） */
+const TIMELINESS_TIMEOUT_MS = 15_000;
+/** 被判定为过时的记忆降级到此 score（接近物理删除阈值，但保留可恢复性） */
+const TIMELINESS_OUTDATED_SCORE = 0.05;
+/** 候选记忆内容预览长度（截断后送入 LLM） */
+const TIMELINESS_CONTENT_PREVIEW_LEN = 200;
 /**
  * 记忆衰减调度器
  *
@@ -43,10 +66,29 @@ export class MemoryDecayScheduler {
     tracer;
     /** 衰减完成事件发射回调 */
     onDecayCompleted;
+    /** 后台 LLM Provider（可选，用于 L2 时效性评估，未注入时跳过） */
+    backgroundProvider;
+    /** 完整记忆存储（可选，用于 L2 读取低分记忆和降级，未注入时跳过） */
+    index;
     /** 衰减定时器（null 表示未启动） */
     decayTimer = null;
     /** 衰减目标存储（start 时注入，stop 时释放） */
     storage = null;
+    /**
+     * L2 时效性评估的 AbortController
+     *
+     * FIX-P0-1：stop() 时 abort，让正在进行的 evaluateTimeliness 尽快结束，
+     * 防止 close 后 LLM 回调 upsert 已关闭的 storage。
+     * 每次 evaluateTimeliness 启动时重置为新的 controller。
+     */
+    evaluateAbortController = null;
+    /**
+     * 当前正在进行的 evaluateTimeliness Promise（null 表示无）
+     *
+     * FIX-P0-1：close() 通过 awaitInflight() 等待此 Promise 完成，
+     * 确保关闭时所有 L2 评估的 upsert 都落在 storage 关闭前。
+     */
+    inflightEvaluate = null;
     // ─── 衰减指标统计字段 ──────────────────────────────────
     /** 衰减执行次数（每次 runOnce 实际执行 +1） */
     metricDecayRunCount = 0;
@@ -57,6 +99,9 @@ export class MemoryDecayScheduler {
     constructor(opts) {
         this.tracer = opts.tracer ?? NOOP_TRACER;
         this.onDecayCompleted = opts.onDecayCompleted;
+        // L2 可选依赖：未注入时 evaluateTimeliness 静默跳过
+        this.backgroundProvider = opts.backgroundProvider ?? null;
+        this.index = opts.index ?? null;
     }
     /**
      * 启动定期衰减
@@ -74,15 +119,44 @@ export class MemoryDecayScheduler {
     /**
      * 停止定期衰减，释放资源
      *
-     * 清理定时器和 storage 引用，防止 close 后回调触发。
+     * FIX-P0-1：清理定时器 + abort 正在进行的 L2 时效性评估 + 释放 storage 引用，
+     * 防止 close 后回调触发 upsert 已关闭的 storage。
+     *
+     * 注意：stop() 不等待 inflightEvaluate 完成（避免阻塞 close 流程），
+     * 调用方如需等待应使用 awaitInflight()。abort 后 LLM 调用会快速失败，
+     * evaluateTimeliness 内部的 try/catch 会捕获并降级返回。
      */
     stop() {
         if (this.decayTimer) {
             clearSafeInterval(this.decayTimer);
             this.decayTimer = null;
         }
+        // FIX-P0-1：abort 正在进行的 L2 评估，让 LLM 调用快速失败
+        if (this.evaluateAbortController) {
+            this.evaluateAbortController.abort();
+            this.evaluateAbortController = null;
+        }
         this.storage = null;
     }
+    /**
+     * 等待正在进行的 L2 时效性评估完成
+     *
+     * FIX-P0-1：Agent.close() 在 stop() 后调用此方法，确保所有 inflight 的
+     * evaluateTimeliness Promise 完成（要么正常返回，要么因 abort 快速 reject），
+     * 防止 close 后 LLM 回调 upsert 已关闭的 storage。
+     *
+     * @returns 完成 Promise，无 inflight 时立即 resolve
+     */
+    async awaitInflight() {
+        if (this.inflightEvaluate) {
+            try {
+                await this.inflightEvaluate;
+            }
+            catch {
+                // abort 导致的 reject 是预期行为，吞掉即可
+            }
+        }
+    }
     /**
      * 执行一次记忆衰减
      *
@@ -99,8 +173,8 @@ export class MemoryDecayScheduler {
         // 衰减 Span：记录衰减执行过程，补全衰减可观测性缺口
         const decaySpan = this.tracer.startSpan(TRACE_SPANS.DECAY);
         try {
-            const sources = [SOURCE_LABELS.INSIGHT, SOURCE_LABELS.PROFILE, SOURCE_LABELS.WORK_PROJECTION];
-            const decayedCount = this.storage.decayScores(sources, new Date());
+            // 治理源列表统一来自 governance.ts（v2 REPEAT-1 闭环）
+            const decayedCount = this.storage.decayScores([...GOVERNANCE_SOURCES], new Date());
             logger.debug({ decayedCount }, '记忆衰减完成');
             // 衰减指标统计：累计执行次数和衰减记忆数
             this.metricDecayRunCount++;
@@ -130,5 +204,210 @@ export class MemoryDecayScheduler {
             lastRunAt: this.metricLastDecayAt,
         };
     }
+    // ─── L2 时效性评估（可选，backgroundProvider + index 注入后启用） ───
+    /**
+     * 时效性评估：扫描低分记忆，调用 LLM 判断是否已过时
+     *
+     * 流程：
+     *   1. 从 insight/profile/work-projection 加载低分记忆（score < 0.3）
+     *   2. 对每条低分记忆（上限 20 条），调用 LLM 判断是否"已过时"
+     *   3. 过时则进一步降级（score → 0.05，接近物理删除阈值但保留可恢复性）
+     *   4. 返回评估报告
+     *
+     * 使用场景：
+     *   - 衰减后调用（onDecayCompleted 回调中），对低分记忆做 LLM 二次评估
+     *   - 宿主定时任务定期调用（如每天一次）
+     *   - 用户手动触发（记忆管理面板的"清理过时记忆"按钮）
+     *
+     * 安全设计：
+     *   - 不物理删除——仅降级 score，保留可恢复性
+     *   - LLM 失败降级——返回已处理的报告，不阻塞调用方
+     *   - 单条 LLM 失败不阻塞后续评估
+     *   - backgroundProvider / index 未注入时静默跳过（向后兼容）
+     *
+     * FIX-P0-1：每次启动评估创建新的 AbortController，注册到 inflightEvaluate。
+     * stop() 时 abort 让 LLM 调用快速失败，awaitInflight() 等待 Promise 完成。
+     * 外部 signal 仍可与内部 abort 信号同时使用（任一触发即取消）。
+     *
+     * @param signal 可选的外部 AbortSignal（与内部 abort 信号叠加，任一触发即取消）
+     * @returns 评估报告
+     */
+    async evaluateTimeliness(signal) {
+        // 可选依赖未注入时静默降级（向后兼容）
+        if (!this.backgroundProvider || !this.index) {
+            return {
+                scannedCount: 0,
+                outdatedCount: 0,
+                demotedIds: [],
+                skippedReason: 'backgroundProvider 或 index 未注入',
+            };
+        }
+        // FIX-P0-1：每次评估创建新的 AbortController，stop() 可主动 abort
+        this.evaluateAbortController = new AbortController();
+        const internalSignal = this.evaluateAbortController.signal;
+        // 外部 signal 与内部 signal 叠加：任一 abort 即触发
+        // 使用 AbortSignal.any 需 Node 18+，兼容方案是手动转发
+        const combinedSignal = signal
+            ? AbortSignal.any([internalSignal, signal])
+            : internalSignal;
+        // 注册到 inflightEvaluate，让 awaitInflight() 可等待
+        const promise = this.doEvaluateTimeliness(combinedSignal);
+        this.inflightEvaluate = promise;
+        try {
+            return await promise;
+        }
+        finally {
+            // 评估完成（成功/失败/abort）后清理引用
+            if (this.inflightEvaluate === promise) {
+                this.inflightEvaluate = null;
+            }
+            if (this.evaluateAbortController?.signal === internalSignal) {
+                this.evaluateAbortController = null;
+            }
+        }
+    }
+    /**
+     * 实际执行 L2 时效性评估的核心逻辑
+     *
+     * 从 evaluateTimeliness 拆出，便于 inflightEvaluate Promise 注册和清理。
+     *
+     * @param combinedSignal 已叠加内部 + 外部的 AbortSignal
+     */
+    async doEvaluateTimeliness(signal) {
+        // ── 步骤 1：加载低分记忆 ──
+        const lowScoreMemories = [];
+        for (const source of GOVERNANCE_SOURCES) {
+            const memories = this.index.getBySource(source);
+            // 筛选低分记忆（score 低于阈值）
+            lowScoreMemories.push(...memories.filter((m) => m.score < TIMELINESS_LOW_SCORE_THRESHOLD));
+        }
+        if (lowScoreMemories.length === 0) {
+            return {
+                scannedCount: 0,
+                outdatedCount: 0,
+                demotedIds: [],
+                skippedReason: '无低分记忆需评估',
+            };
+        }
+        // 按 score 升序排列（最低分优先评估），取前 20 条
+        lowScoreMemories.sort((a, b) => a.score - b.score);
+        const limited = lowScoreMemories.slice(0, TIMELINESS_EVALUATE_LIMIT);
+        // ── 步骤 2：逐条调用 LLM 判断时效性 ──
+        const demotedIds = [];
+        let outdatedCount = 0;
+        for (const memory of limited) {
+            // abort 后提前退出循环，避免无谓的 LLM 调用
+            if (signal.aborted)
+                break;
+            try {
+                const verdict = await this.judgeTimeliness(memory, signal);
+                if (verdict.isOutdated) {
+                    this.demoteOutdatedMemory(memory);
+                    demotedIds.push(memory.id);
+                    outdatedCount++;
+                    logger.info({ memoryId: memory.id, reason: verdict.reason }, '时效性评估：降级过时记忆');
+                }
+            }
+            catch (err) {
+                // 单条 LLM 判断失败不阻塞后续评估（abort 导致的失败也走此分支）
+                logger.warn({ err, memoryId: memory.id }, '时效性评估：LLM 判断失败，跳过此条');
+            }
+        }
+        return {
+            scannedCount: limited.length,
+            outdatedCount,
+            demotedIds,
+        };
+    }
+    /**
+     * 调用 LLM 判断单条记忆的时效性
+     *
+     * 使用结构化 JSON 输出（isOutdated + reason），
+     * 流式累积 + parseLlmJson + 异常封装委托给 llmJudgeHelper.judgeWithLlm。
+     *
+     * LLM 失败时抛出 MemoraError（由 evaluateTimeliness 捕获并降级跳过此条）。
+     *
+     * @param memory 待评估的记忆
+     * @param signal 可选的 AbortSignal
+     * @returns LLM 判断结果
+     */
+    async judgeTimeliness(memory, signal) {
+        const messages = buildTimelinessMessages(memory);
+        const parsed = await judgeWithLlm(this.backgroundProvider, messages, { maxTokens: 200, timeoutMs: TIMELINESS_TIMEOUT_MS, signal }, 'LLM 时效性判断返回非法 JSON');
+        return {
+            memoryId: memory.id,
+            isOutdated: parsed.isOutdated === true,
+            reason: typeof parsed.reason === 'string' ? parsed.reason : '(LLM 未提供理由)',
+        };
+    }
+    /**
+     * 降级过时记忆（score → TIMELINESS_OUTDATED_SCORE）
+     *
+     * 安全设计：
+     *   - 不物理删除，仅降低 score，保留可恢复性
+     *   - 更新 accessedAt，标记最近被处理过
+     *
+     * @param memory 待降级的过时记忆
+     */
+    demoteOutdatedMemory(memory) {
+        // MIND2-L3：改用 setScore 原子操作，消除 spread 旧快照覆盖其他字段
+        // 原模式 spread 旧快照后整条 upsert，会覆盖期间被 boost/decay 改的 content 等字段
+        this.index.setScore(memory.id, TIMELINESS_OUTDATED_SCORE, nowIso());
+    }
+}
+// ─── L2 时效性评估 Prompt 模板（模块级函数，与 buildDedupMessages 同模式） ───
+/**
+ * 构建时效性判断的 LLM 消息
+ *
+ * 设计要点：
+ *   - system 消息定义判断规则（过时 = 信息已失效/不再适用）
+ *   - user 消息携带记忆内容和元数据（source/score/createdAt）
+ *   - 要求输出结构化 JSON（isOutdated + reason）
+ *   - few-shot 示例降低 LLM 误判率
+ *
+ * @param memory 待评估的记忆
+ * @returns system + user 消息数组
+ */
+function buildTimelinessMessages(memory) {
+    const content = memory.content.length > TIMELINESS_CONTENT_PREVIEW_LEN
+        ? truncate(memory.content, TIMELINESS_CONTENT_PREVIEW_LEN, '…[截断]')
+        : memory.content;
+    return [
+        {
+            role: 'system',
+            content: `你是记忆时效性评估助手。判断给定的记忆是否已过时（信息已失效或不再适用）。
+
+判断规则：
+- 已过时 = 信息明确失效（如旧版本号、已废弃的 API、已变更的偏好）
+- 未过时 = 信息仍然有效（如通用编程原则、长期偏好、历史事件记录）
+- 不确定时倾向"未过时"（避免误删有效记忆）
+
+输出 JSON 格式：
+{
+  "isOutdated": true/false,
+  "reason": "判断理由（简短说明）"
+}
+
+示例：
+输入: "用户使用 React 16 进行开发"（createdAt: 2020-01-01）
+输出: {"isOutdated": true, "reason": "React 16 已是旧版本，当前普遍使用 React 18+"}
+
+输入: "用户偏好函数式编程风格"
+输出: {"isOutdated": false, "reason": "编程风格偏好通常是长期的"}`,
+        },
+        {
+            role: 'user',
+            content: `请判断以下记忆是否已过时：
+
+记忆详情：
+- 名称：${memory.name}
+- 来源：${memory.source}
+- 当前 score：${memory.score}（低分，可能因长期未访问而衰减）
+- 创建时间：${memory.createdAt}
+- 内容：${content}
+
+请输出 JSON 判断结果。`,
+        },
+    ];
 }
 //# sourceMappingURL=memoryDecayScheduler.js.map

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * 记忆治理统一门面 — 聚合 L0–L3 记忆治理操作
+ *
+ * 职责：
+ *   - L0 衰减：手动触发 score 自然衰减
+ *   - L1 去重：语义重复检测与合并
+ *   - L2 时效性：LLM 驱动的时效性评估
+ *   - L3 冲突：LLM 驱动的语义冲突检测
+ *   - 诊断：source 健康度 + 记忆推荐
+ *
+ * 设计原则（§2.2 借力生长）：
+ *   - 6 个治理方法原散落在 Agent 的 45 个公开 API 中，职责碎片化
+ *   - 收束为单一门面，Agent 只暴露 `agent.governance.xxx()`，减少 6 个直接 API 入口
+ *   - 门面仅做委托和空值降级，不引入新逻辑——每一层抽象对应一个真实故障点
+ *
+ * 空值降级策略：
+ *   - 底层 Manager 未注入时返回空报告（非抛错），符合"降级优先"原则
+ *   - 与 L1/L2/L3 层的 skippedReason 语义一致
+ */
+import type { DedupManager, DedupReport } from '../../agent/managers/dedupManager.js';
+import type { MemoryDecayScheduler, TimelinessReport } from '../../agent/managers/memoryDecayScheduler.js';
+import type { MemoryAdvisor, ConflictReport } from '../../agent/managers/memoryAdvisor.js';
+import type { SourceHealthReport, SuggestOptions, SuggestHit } from '../../agent/managers/memoryAdvisor.js';
+export declare class MemoryGovernance {
+    private readonly dedupManager;
+    private readonly decayScheduler;
+    private readonly memoryAdvisor;
+    constructor(dedupManager: DedupManager | null, decayScheduler: MemoryDecayScheduler | null, memoryAdvisor: MemoryAdvisor | null);
+    /**
+     * 手动触发一次记忆衰减（纯 score 递减，无 LLM 调用）
+     */
+    decay(): void;
+    /**
+     * 语义去重：扫描名称相似记忆对，LLM 判断等价性，降级重复记忆
+     */
+    deduplicate(signal?: AbortSignal): Promise<DedupReport>;
+    /**
+     * 时效性评估：LLM 判断低分记忆是否过时，降级过时记忆
+     */
+    evaluateTimeliness(signal?: AbortSignal): Promise<TimelinessReport>;
+    /**
+     * 冲突检测：LLM 判断同 source 记忆是否存在语义矛盾
+     */
+    detectConflicts(signal?: AbortSignal): Promise<ConflictReport>;
+    /**
+     * 记忆源健康诊断（纯只读，不修改状态）
+     *
+     * @returns 健康报告；advisor 未注入时返回 null
+     */
+    sourceHealth(): SourceHealthReport | null;
+    /**
+     * 记忆关联推荐（纯只读，不修改状态）
+     */
+    suggest(query?: string, options?: SuggestOptions): SuggestHit[];
+}
+//# sourceMappingURL=memoryGovernance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memoryGovernance.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/memoryGovernance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AACvG,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAExG,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAFb,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,cAAc,EAAE,oBAAoB,GAAG,IAAI,EAC3C,aAAa,EAAE,aAAa,GAAG,IAAI;IAKtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACG,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAS7D;;OAEG;IACG,kBAAkB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IASzE;;OAEG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IASpE;;;;OAIG;IACH,YAAY,IAAI,kBAAkB,GAAG,IAAI;IAIzC;;OAEG;IACH,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,EAAE;CAGhE"}

package/dist/agent/managers/memoryGovernance.js

@@ -0,0 +1,63 @@
+export class MemoryGovernance {
+    dedupManager;
+    decayScheduler;
+    memoryAdvisor;
+    constructor(dedupManager, decayScheduler, memoryAdvisor) {
+        this.dedupManager = dedupManager;
+        this.decayScheduler = decayScheduler;
+        this.memoryAdvisor = memoryAdvisor;
+    }
+    // ── L0 衰减 ──────────────────────────────────────────
+    /**
+     * 手动触发一次记忆衰减（纯 score 递减，无 LLM 调用）
+     */
+    decay() {
+        this.decayScheduler?.runOnce();
+    }
+    // ── L1 语义去重 ──────────────────────────────────────
+    /**
+     * 语义去重：扫描名称相似记忆对，LLM 判断等价性，降级重复记忆
+     */
+    async deduplicate(signal) {
+        if (!this.dedupManager) {
+            return { scannedCount: 0, pairCount: 0, deduplicatedCount: 0, demotedIds: [], skippedReason: 'Agent 未初始化' };
+        }
+        return this.dedupManager.deduplicateMemories(signal);
+    }
+    // ── L2 时效性评估 ────────────────────────────────────
+    /**
+     * 时效性评估：LLM 判断低分记忆是否过时，降级过时记忆
+     */
+    async evaluateTimeliness(signal) {
+        if (!this.decayScheduler) {
+            return { scannedCount: 0, outdatedCount: 0, demotedIds: [], skippedReason: 'Agent 未初始化' };
+        }
+        return this.decayScheduler.evaluateTimeliness(signal);
+    }
+    // ── L3 冲突检测 ──────────────────────────────────────
+    /**
+     * 冲突检测：LLM 判断同 source 记忆是否存在语义矛盾
+     */
+    async detectConflicts(signal) {
+        if (!this.memoryAdvisor) {
+            return { scannedCount: 0, pairCount: 0, conflictCount: 0, conflicts: [], skippedReason: 'Agent 未初始化' };
+        }
+        return this.memoryAdvisor.detectConflicts(signal);
+    }
+    // ── 诊断 ─────────────────────────────────────────────
+    /**
+     * 记忆源健康诊断（纯只读，不修改状态）
+     *
+     * @returns 健康报告；advisor 未注入时返回 null
+     */
+    sourceHealth() {
+        return this.memoryAdvisor?.sourceHealth() ?? null;
+    }
+    /**
+     * 记忆关联推荐（纯只读，不修改状态）
+     */
+    suggest(query, options) {
+        return this.memoryAdvisor?.suggest(query, options) ?? [];
+    }
+}
+//# sourceMappingURL=memoryGovernance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memoryGovernance.js","sourceRoot":"","sources":["../../../src/agent/managers/memoryGovernance.ts"],"names":[],"mappings":"AA2BA,MAAM,OAAO,gBAAgB;IAER;IACA;IACA;IAHnB,YACmB,YAAiC,EACjC,cAA2C,EAC3C,aAAmC;QAFnC,iBAAY,GAAZ,YAAY,CAAqB;QACjC,mBAAc,GAAd,cAAc,CAA6B;QAC3C,kBAAa,GAAb,aAAa,CAAsB;IACnD,CAAC;IAEJ,sDAAsD;IAEtD;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,CAAC;IACjC,CAAC;IAED,oDAAoD;IAEpD;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,MAAoB;QACpC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;QAC9G,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;IAED,mDAAmD;IAEnD;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,MAAoB;QAC3C,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;QAC5F,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,oDAAoD;IAEpD;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,MAAoB;QACxC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;QACzG,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,sDAAsD;IAEtD;;;;OAIG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,aAAa,EAAE,YAAY,EAAE,IAAI,IAAI,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,KAAc,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;IAC3D,CAAC;CACF"}