openclaw-cortex-memory 0.1.0-Alpha.4 → 0.1.0-Alpha.5

package/README.md

@@ -14,6 +14,32 @@ OpenClaw 长期记忆插件，提供跨会话检索、事件存储、规则反
 | 规则演进 | `reflect_memory` 更新 `CORTEX_RULES.md` |
 | 运行诊断 | `diagnostics` 检查本地存储状态 |
 
+## 记忆库组成与特点
+
+### 组成结构
+
+| 层级 | 核心文件/数据 | 作用 |
+|------|---------------|------|
+| 会话记忆层 | `sessions/active/sessions.jsonl` | 存储最近会话消息，支撑实时检索与上下文注入 |
+| 事件归档层 | `sessions/archive/sessions.jsonl` | 存储已沉淀事件（摘要、实体、结果），用于长期回顾 |
+| 实体关系层 | 基于归档事件中的 `entities` / `relations` 字段动态构图 | 支撑 `query_graph` 的实体共现与关系查询（派生图谱，不单独落盘） |
+| 向量检索层 | `vector/lancedb`（可用时）或 `vector/lancedb_events.jsonl`（回退） | 存储事件向量，用于语义检索与向量去重 |
+| 规则知识层 | `CORTEX_RULES.md` | 存储由反思生成的可复用规则，供后续任务复用 |
+| 运行状态层 | `.sync_state.json` / `.session_end_state.json` / `.rule_store_state.json` / `.dedup_index.json` / `graph/mutation_log.jsonl` | 记录增量同步、session_end 幂等、规则去重、三阶段去重索引、图谱变更审计日志 |
+| 说明与入口层 | `MEMORY.md` | 记忆库说明与使用约定入口 |
+
+### 核心特点
+
+- 分层记忆：把“原始会话、结构化事件、抽象规则”拆分存储，便于分别检索与治理
+- 图谱派生：实体关系来自事件层的 `entities` / `relations`，查询时动态生成图结构
+- 图谱治理：写入前按 `schema/graph.schema.yaml` 做 event/relation 规范化与关系规则校验
+- 会话结束写入：message hook 默认仅缓存，会在 `session_end` 后批量抽取并落盘
+- 增量导入：通过状态文件只处理新增会话内容，避免全量重复扫描
+- 幂等去重：对 session_end 事件和规则写入做签名判重，减少重复沉淀
+- 三阶段去重：SimHash 预过滤 → MinHash 精比对 → 向量余弦相似度
+- 自动演进：可结合 `autoSync`、`autoReflect` 持续把会话经验转化为长期可复用记忆
+- 可观测可诊断：通过 `diagnostics` 与状态文件快速定位数据目录、同步与反思异常
+
 ## 安装
 
 ### 前置要求
@@ -63,7 +89,7 @@ cd openclaw-cortex-memory
 npm install
 ```
 
-`npm install` 会自动执行 TypeScript 构建并生成 `dist/`，但这种方式默认不写 OpenClaw 安装记录。
+`npm install` 不会自动构建 `dist/`，源码模式请显式执行 `npm run build`，且这种方式默认不写 OpenClaw 安装记录。
 
 ## 配置
 
@@ -81,7 +107,33 @@ npm install
           "engineMode": "ts",
           "dbPath": "<optional-memory-dir>",
           "autoSync": true,
-          "autoReflect": true,
+          "autoReflect": false,
+          "autoReflectIntervalMinutes": 30,
+          "readFusion": {
+            "enabled": true,
+            "maxCandidates": 10,
+            "authoritative": true
+          },
+          "memoryDecay": {
+            "enabled": true,
+            "minFloor": 0.15,
+            "defaultHalfLifeDays": 90,
+            "halfLifeByEventType": {
+              "issue": 30,
+              "fix": 30,
+              "action_item": 30,
+              "decision": 120,
+              "preference": 240,
+              "constraint": 240,
+              "requirement": 240
+            },
+            "antiDecay": {
+              "enabled": true,
+              "maxBoost": 1.6,
+              "hitWeight": 0.08,
+              "recentWindowDays": 30
+            }
+          },
           "embedding": {
             "provider": "api",
             "model": "text-embedding-3-large",
@@ -108,6 +160,14 @@ npm install
 }
 ```
 
+### 关键功能开关（建议显式配置）
+
+- `readFusion.enabled`：开启多路召回后 LLM 融合
+- `readFusion.authoritative`：开启后仅返回融合后的权威记忆包
+- `memoryDecay.enabled`：开启按 `event_type` 半衰期衰减
+- `memoryDecay.antiDecay.enabled`：开启命中频次反衰减，避免高价值老记忆被过度衰减
+- `autoReflect`：建议在验证稳定后再开启；默认 `false`
+
 ### 配置项说明
 
 | 配置项 | 必填 | 说明 |
@@ -129,6 +189,18 @@ npm install
 | `dbPath` | 否 | 数据目录，默认 `<plugin-dir>/data/memory` |
 | `autoSync` | 否 | 会话结束时自动同步历史记录，默认 `true` |
 | `autoReflect` | 否 | 自动触发记忆反思，默认 `false` |
+| `autoReflectIntervalMinutes` | 否 | 自动反思扫描间隔（分钟），默认 `30`，最小 `5` |
+| `readFusion.enabled` | 否 | 启用重排后 LLM 融合，默认 `true` |
+| `readFusion.maxCandidates` | 否 | 融合候选上限，默认 `10` |
+| `readFusion.authoritative` | 否 | 仅返回融合权威记忆包，默认 `true` |
+| `memoryDecay.enabled` | 否 | 启用按 `event_type` 的半衰期衰减，默认 `true` |
+| `memoryDecay.minFloor` | 否 | 衰减系数下限（0~1），默认 `0.15` |
+| `memoryDecay.defaultHalfLifeDays` | 否 | 未配置类型的默认半衰期（天），默认 `90` |
+| `memoryDecay.halfLifeByEventType` | 否 | 各 `event_type` 半衰期覆盖配置（天） |
+| `memoryDecay.antiDecay.enabled` | 否 | 启用命中频次反衰减，默认 `true` |
+| `memoryDecay.antiDecay.maxBoost` | 否 | 反衰减最大增益（>=1），默认 `1.6` |
+| `memoryDecay.antiDecay.hitWeight` | 否 | 命中次数增益系数，默认 `0.08` |
+| `memoryDecay.antiDecay.recentWindowDays` | 否 | 命中新鲜度窗口（天），默认 `30` |
 
 ### 启动
 
@@ -161,7 +233,7 @@ pnpm openclaw gateway restart
 |------|------|
 | `search_memory` | 语义搜索记忆库，支持 top_k 参数 |
 | `store_event` | 存储事件，可包含实体和关系 |
-| `query_graph` | 查询实体关系图谱 |
+| `query_graph` | 查询实体关系图谱，支持关系过滤、方向过滤与路径查询 |
 | `get_hot_context` | 获取热上下文（CORTEX_RULES.md + 近期会话） |
 | `get_auto_context` | 自动检索相关记忆 + 热上下文 |
 | `reflect_memory` | 触发记忆反思，将事件转化为规则 |
@@ -190,9 +262,14 @@ npx cortex-memory help                # 查看命令帮助
 | `<dbPath>/CORTEX_RULES.md` | 规则文件 |
 | `<dbPath>/sessions/active/sessions.jsonl` | 活跃会话 |
 | `<dbPath>/sessions/archive/sessions.jsonl` | 归档事件 |
+| `<dbPath>/vector/lancedb` | LanceDB 向量表（可用时） |
+| `<dbPath>/vector/lancedb_events.jsonl` | 向量回退存储（LanceDB不可用时） |
 | `<dbPath>/.sync_state.json` | 同步增量状态 |
 | `<dbPath>/.session_end_state.json` | session_end 幂等状态 |
 | `<dbPath>/.rule_store_state.json` | 规则去重状态 |
+| `<dbPath>/.dedup_index.json` | 三阶段去重索引 |
+| `<dbPath>/.read_hit_stats.json` | 检索命中频次统计（用于反衰减增益） |
+| `<dbPath>/graph/mutation_log.jsonl` | 图谱写入审计日志（canonical_id/source_event_id/actor/timestamp） |
 
 ## 注意事项
 
@@ -202,6 +279,8 @@ npx cortex-memory help                # 查看命令帮助
 4. **外部传输**：检索与反思会调用你配置的 embedding/llm/reranker endpoint，请使用可信服务并最小化密钥权限
 5. **会话数据**：启用 `autoSync` 时会读取 OpenClaw 会话文件并写入本地记忆目录，生产环境建议先小范围验证
 6. **单栈运行**：当前版本为纯 TS，无 Python 运行时依赖
+7. **历史导入来源**：`sync_memory` 会同时导入 `<openclaw_base>/agents/main/sessions/*.jsonl` 与 `<openclaw_base>/workspace/memory/*.md`
+8. **重复导入防护**：每日总结 `.md` 会按文件内容哈希标记在 `.sync_state.json`，未变化文件不会重复导入
 
 ## 许可证
 

package/SKILL.md

@@ -76,7 +76,7 @@ git clone https://github.com/deki18/openclaw-cortex-memory.git ~/openclaw-cortex
 cd ~/openclaw-cortex-memory-src
 npm install && npm run build && npm pack
 cd ~/openclaw
-pnpm openclaw plugins install ~/openclaw-cortex-memory-src/openclaw-cortex-memory-0.1.0-Alpha.4.tgz
+pnpm openclaw plugins install ~/openclaw-cortex-memory-src/openclaw-cortex-memory-0.1.0-Alpha.5.tgz
 pnpm openclaw gateway restart
 ```
 
@@ -105,7 +105,33 @@ npm install
           "engineMode": "ts",
           "dbPath": "<optional-memory-dir>",
           "autoSync": true,
-          "autoReflect": true,
+          "autoReflect": false,
+          "autoReflectIntervalMinutes": 30,
+          "readFusion": {
+            "enabled": true,
+            "maxCandidates": 10,
+            "authoritative": true
+          },
+          "memoryDecay": {
+            "enabled": true,
+            "minFloor": 0.15,
+            "defaultHalfLifeDays": 90,
+            "halfLifeByEventType": {
+              "issue": 30,
+              "fix": 30,
+              "action_item": 30,
+              "decision": 120,
+              "preference": 240,
+              "constraint": 240,
+              "requirement": 240
+            },
+            "antiDecay": {
+              "enabled": true,
+              "maxBoost": 1.6,
+              "hitWeight": 0.08,
+              "recentWindowDays": 30
+            }
+          },
           "embedding": {
             "provider": "api",
             "model": "text-embedding-3-large",
@@ -132,6 +158,14 @@ npm install
 }
 ```
 
+关键功能开关（建议显式配置）：
+
+- `readFusion.enabled`：开启多路召回后的 LLM 融合
+- `readFusion.authoritative`：仅返回融合后的权威记忆包
+- `memoryDecay.enabled`：开启按事件类型的半衰期衰减
+- `memoryDecay.antiDecay.enabled`：开启命中频次反衰减
+- `autoReflect`：建议验证稳定后再开启（默认 false）
+
 ### 启动
 
 ```bash
@@ -183,12 +217,16 @@ openclaw gateway restart
 
 ### query_graph
 
-查询归档事件中的实体共现关系。
+查询归档事件中的实体关系（relations 优先，共现关系回退）。
 
 **参数：**
 | 参数 | 类型 | 必需 | 说明 |
 |------|------|------|------|
 | entity | string | 是 | 实体名称 |
+| rel | string | 否 | 关系类型过滤（如 `depends_on`） |
+| dir | string | 否 | 方向过滤：`incoming` / `outgoing` / `both` |
+| path_to | string | 否 | 查询从 `entity` 到目标实体的路径 |
+| max_depth | number | 否 | 路径最大深度（2~4） |
 
 ### get_hot_context
 
@@ -250,6 +288,18 @@ openclaw gateway restart
 | engineMode | 否 | `ts` | 固定为 TS 引擎 |
 | autoSync | 否 | true | 会话结束自动同步 |
 | autoReflect | 否 | false | 自动触发反思 |
+| autoReflectIntervalMinutes | 否 | 30 | 自动反思扫描间隔（分钟） |
+| readFusion.enabled | 否 | true | 启用检索重排后的 LLM 融合 |
+| readFusion.maxCandidates | 否 | 10 | 融合候选上限 |
+| readFusion.authoritative | 否 | true | 仅返回融合权威记忆包 |
+| memoryDecay.enabled | 否 | true | 启用按事件类型半衰期衰减 |
+| memoryDecay.minFloor | 否 | 0.15 | 衰减系数下限 |
+| memoryDecay.defaultHalfLifeDays | 否 | 90 | 未配置类型默认半衰期（天） |
+| memoryDecay.halfLifeByEventType | 否 | - | 各事件类型半衰期覆盖配置 |
+| memoryDecay.antiDecay.enabled | 否 | true | 启用命中频次反衰减 |
+| memoryDecay.antiDecay.maxBoost | 否 | 1.6 | 反衰减最大增益 |
+| memoryDecay.antiDecay.hitWeight | 否 | 0.08 | 命中次数增益系数 |
+| memoryDecay.antiDecay.recentWindowDays | 否 | 30 | 命中新鲜度窗口（天） |
 
 ## 数据文件
 
@@ -259,9 +309,14 @@ openclaw gateway restart
 | `<dbPath>/CORTEX_RULES.md` | 规则文件 |
 | `<dbPath>/sessions/active/sessions.jsonl` | 活跃会话记忆 |
 | `<dbPath>/sessions/archive/sessions.jsonl` | 归档事件 |
+| `<dbPath>/vector/lancedb` | LanceDB 向量表（可用时） |
+| `<dbPath>/vector/lancedb_events.jsonl` | 向量回退存储（LanceDB 不可用时） |
 | `<dbPath>/.sync_state.json` | 同步增量状态 |
 | `<dbPath>/.session_end_state.json` | session_end 幂等状态 |
 | `<dbPath>/.rule_store_state.json` | 规则去重状态 |
+| `<dbPath>/.dedup_index.json` | 三阶段去重索引 |
+| `<dbPath>/.read_hit_stats.json` | 检索命中频次统计（反衰减） |
+| `<dbPath>/graph/mutation_log.jsonl` | 图谱变更审计日志 |
 
 ## 错误处理
 

package/dist/index.d.ts

@@ -29,6 +29,24 @@ interface CortexMemoryConfig {
     dbPath?: string;
     autoSync?: boolean;
     autoReflect?: boolean;
+    autoReflectIntervalMinutes?: number;
+    readFusion?: {
+        enabled?: boolean;
+        maxCandidates?: number;
+        authoritative?: boolean;
+    };
+    memoryDecay?: {
+        enabled?: boolean;
+        minFloor?: number;
+        defaultHalfLifeDays?: number;
+        halfLifeByEventType?: Record<string, number>;
+        antiDecay?: {
+            enabled?: boolean;
+            maxBoost?: number;
+            hitWeight?: number;
+            recentWindowDays?: number;
+        };
+    };
     fallbackToBuiltin?: boolean;
     apiUrl?: string;
     engineMode?: EngineMode;

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -46,10 +46,13 @@ const net = __importStar(require("net"));
 const ts_engine_1 = require("./src/engine/ts_engine");
 const read_store_1 = require("./src/store/read_store");
 const write_store_1 = require("./src/store/write_store");
+const archive_store_1 = require("./src/store/archive_store");
+const vector_store_1 = require("./src/store/vector_store");
 const session_sync_1 = require("./src/sync/session_sync");
 const session_end_1 = require("./src/session/session_end");
 const rule_store_1 = require("./src/rules/rule_store");
 const reflector_1 = require("./src/reflect/reflector");
+const three_stage_deduplicator_1 = require("./src/dedup/three_stage_deduplicator");
 const ERROR_CODES = {
     CONNECTION_REFUSED: {
         code: "E001",
@@ -89,6 +92,40 @@ const MAX_OPENCLAW_VERSION = "2027.0.0";
 const defaultConfig = {
     autoSync: true,
     autoReflect: false,
+    autoReflectIntervalMinutes: 30,
+    readFusion: {
+        enabled: true,
+        maxCandidates: 10,
+        authoritative: true,
+    },
+    memoryDecay: {
+        enabled: true,
+        minFloor: 0.15,
+        defaultHalfLifeDays: 90,
+        antiDecay: {
+            enabled: true,
+            maxBoost: 1.6,
+            hitWeight: 0.08,
+            recentWindowDays: 30,
+        },
+        halfLifeByEventType: {
+            issue: 30,
+            fix: 30,
+            action_item: 30,
+            blocker: 30,
+            plan: 60,
+            milestone: 60,
+            follow_up: 60,
+            decision: 120,
+            insight: 120,
+            retrospective: 120,
+            preference: 240,
+            constraint: 240,
+            requirement: 240,
+            dependency: 240,
+            assumption: 240,
+        },
+    },
     enabled: true,
     fallbackToBuiltin: true,
     engineMode: "ts",
@@ -194,6 +231,9 @@ function resolveEngine() {
         logger,
         embedding: config.embedding,
         reranker: config.reranker,
+        llm: config.llm,
+        fusion: config.readFusion,
+        memoryDecay: config.memoryDecay,
     });
     const writeStore = (0, write_store_1.createWriteStore)({
         projectRoot,
@@ -201,6 +241,22 @@ function resolveEngine() {
         logger,
         embedding: config.embedding,
     });
+    const vectorStore = (0, vector_store_1.createVectorStore)({
+        memoryRoot,
+        logger,
+    });
+    const deduplicator = (0, three_stage_deduplicator_1.createThreeStageDeduplicator)({
+        memoryRoot,
+        logger,
+    });
+    const archiveStore = (0, archive_store_1.createArchiveStore)({
+        projectRoot,
+        memoryRoot,
+        logger,
+        embedding: config.embedding,
+        deduplicator,
+        vectorStore,
+    });
     const sessionSync = (0, session_sync_1.createSessionSync)({
         projectRoot,
         dbPath: config.dbPath,
@@ -212,6 +268,9 @@ function resolveEngine() {
         dbPath: config.dbPath,
         logger,
         syncMemory: sessionSync.syncMemory,
+        syncDailySummaries: sessionSync.syncDailySummaries,
+        archiveStore,
+        llm: config.llm,
     });
     const ruleStore = (0, rule_store_1.createRuleStore)({
         projectRoot,
@@ -228,10 +287,12 @@ function resolveEngine() {
     memoryEngine = (0, ts_engine_1.createTsEngine)({
         readStore,
         writeStore,
+        archiveStore,
         sessionSync,
         sessionEnd,
         reflector,
         memoryRoot,
+        projectRoot,
         getCachedAutoSearch: getSessionCachedAutoSearch,
         resolveSessionId: (context, payload) => resolveSessionId(context, payload),
         normalizeIncomingMessage,
@@ -523,6 +584,8 @@ function startAutoReflectScheduler() {
     if (!config?.autoReflect || autoReflectInterval) {
         return;
     }
+    const intervalMinutes = Math.max(5, Math.floor(config.autoReflectIntervalMinutes ?? 30));
+    const intervalMs = intervalMinutes * 60 * 1000;
     autoReflectInterval = setInterval(() => {
         if (!isEnabled) {
             return;
@@ -539,7 +602,7 @@ function startAutoReflectScheduler() {
         if (marker === lastAutoReflectArchiveMarker) {
             return;
         }
-        if (now - lastAutoReflectRunAt < 5 * 60 * 1000) {
+        if (now - lastAutoReflectRunAt < intervalMs) {
             return;
         }
         resolveEngine().reflectMemory({}, schedulerContext)
@@ -554,7 +617,7 @@ function startAutoReflectScheduler() {
             }
         })
             .catch(error => logger.warn(`Auto-reflect failed: ${String(error)}`));
-    }, 5 * 60 * 1000);
+    }, intervalMs);
 }
 function stopAutoReflectScheduler() {
     if (autoReflectInterval) {
@@ -582,6 +645,41 @@ function validateConfig(cfg) {
     if (!cfg.reranker?.apiKey || !cfg.reranker?.baseURL) {
         errors.push("reranker.apiKey and reranker.baseURL are required. Please configure third-party reranker endpoint credentials.");
     }
+    if (typeof cfg.autoReflectIntervalMinutes === "number" && (!Number.isFinite(cfg.autoReflectIntervalMinutes) || cfg.autoReflectIntervalMinutes < 5)) {
+        errors.push("autoReflectIntervalMinutes must be a number >= 5.");
+    }
+    if (cfg.readFusion && typeof cfg.readFusion.maxCandidates === "number" && (!Number.isFinite(cfg.readFusion.maxCandidates) || cfg.readFusion.maxCandidates < 2)) {
+        errors.push("readFusion.maxCandidates must be a number >= 2.");
+    }
+    if (cfg.memoryDecay) {
+        if (typeof cfg.memoryDecay.minFloor === "number" && (!Number.isFinite(cfg.memoryDecay.minFloor) || cfg.memoryDecay.minFloor < 0 || cfg.memoryDecay.minFloor > 1)) {
+            errors.push("memoryDecay.minFloor must be within [0,1].");
+        }
+        if (typeof cfg.memoryDecay.defaultHalfLifeDays === "number" && (!Number.isFinite(cfg.memoryDecay.defaultHalfLifeDays) || cfg.memoryDecay.defaultHalfLifeDays <= 0)) {
+            errors.push("memoryDecay.defaultHalfLifeDays must be > 0.");
+        }
+        const mapping = cfg.memoryDecay.halfLifeByEventType;
+        if (mapping && typeof mapping === "object") {
+            for (const [key, value] of Object.entries(mapping)) {
+                if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+                    errors.push(`memoryDecay.halfLifeByEventType.${key} must be > 0.`);
+                    break;
+                }
+            }
+        }
+        const anti = cfg.memoryDecay.antiDecay;
+        if (anti) {
+            if (typeof anti.maxBoost === "number" && (!Number.isFinite(anti.maxBoost) || anti.maxBoost < 1)) {
+                errors.push("memoryDecay.antiDecay.maxBoost must be >= 1.");
+            }
+            if (typeof anti.hitWeight === "number" && (!Number.isFinite(anti.hitWeight) || anti.hitWeight < 0)) {
+                errors.push("memoryDecay.antiDecay.hitWeight must be >= 0.");
+            }
+            if (typeof anti.recentWindowDays === "number" && (!Number.isFinite(anti.recentWindowDays) || anti.recentWindowDays <= 0)) {
+                errors.push("memoryDecay.antiDecay.recentWindowDays must be > 0.");
+            }
+        }
+    }
     return errors;
 }
 function getApiHostAndPort() {
@@ -1895,6 +1993,24 @@ function register(pluginApi, userConfig) {
         dbPath: effectiveConfig.dbPath,
         autoSync: effectiveConfig.autoSync ?? defaultConfig.autoSync,
         autoReflect: effectiveConfig.autoReflect ?? defaultConfig.autoReflect,
+        autoReflectIntervalMinutes: effectiveConfig.autoReflectIntervalMinutes ?? defaultConfig.autoReflectIntervalMinutes,
+        readFusion: {
+            enabled: effectiveConfig.readFusion?.enabled ?? defaultConfig.readFusion?.enabled,
+            maxCandidates: effectiveConfig.readFusion?.maxCandidates ?? defaultConfig.readFusion?.maxCandidates,
+            authoritative: effectiveConfig.readFusion?.authoritative ?? defaultConfig.readFusion?.authoritative,
+        },
+        memoryDecay: {
+            enabled: effectiveConfig.memoryDecay?.enabled ?? defaultConfig.memoryDecay?.enabled,
+            minFloor: effectiveConfig.memoryDecay?.minFloor ?? defaultConfig.memoryDecay?.minFloor,
+            defaultHalfLifeDays: effectiveConfig.memoryDecay?.defaultHalfLifeDays ?? defaultConfig.memoryDecay?.defaultHalfLifeDays,
+            halfLifeByEventType: effectiveConfig.memoryDecay?.halfLifeByEventType ?? defaultConfig.memoryDecay?.halfLifeByEventType,
+            antiDecay: {
+                enabled: effectiveConfig.memoryDecay?.antiDecay?.enabled ?? defaultConfig.memoryDecay?.antiDecay?.enabled,
+                maxBoost: effectiveConfig.memoryDecay?.antiDecay?.maxBoost ?? defaultConfig.memoryDecay?.antiDecay?.maxBoost,
+                hitWeight: effectiveConfig.memoryDecay?.antiDecay?.hitWeight ?? defaultConfig.memoryDecay?.antiDecay?.hitWeight,
+                recentWindowDays: effectiveConfig.memoryDecay?.antiDecay?.recentWindowDays ?? defaultConfig.memoryDecay?.antiDecay?.recentWindowDays,
+            },
+        },
         enabled: effectiveConfig.enabled ?? defaultConfig.enabled,
         fallbackToBuiltin: effectiveConfig.fallbackToBuiltin ?? defaultConfig.fallbackToBuiltin,
         apiUrl: effectiveConfig.apiUrl ?? "http://127.0.0.1:8765",