@zooique/memora 0.1.0

package/dist/logging/logger.js

@@ -0,0 +1,279 @@
+import { statSync, truncateSync } from 'node:fs';
+import { toError } from '../utils/toError.js';
+// 桥接 utils 层 loggerHolder：utils 运行时不依赖 logging/，
+// 由本模块在加载和 setLogger 时反向注入 logger 实例。
+import { setLogger as setUtilsLogger } from '../utils/loggerHolder.js';
+/**
+ * 从 unknown 值提取错误消息（复用零依赖的 toError，避免类型断言）
+ */
+function errMsg(err) {
+    return toError(err).message;
+}
+/** 日志级别（从环境变量读取，默认 info） */
+const level = process.env['MEMORA_LOG_LEVEL'] ?? 'info';
+/** 敏感键模式（匹配时值被替换为 [REDACTED]） */
+const SENSITIVE_KEY_PATTERN = /api[_-]?key|token|password|secret|authorization|credential/i;
+/**
+ * pino redact 路径配置（与 console fallback 的 SENSITIVE_KEY_PATTERN 保持一致）
+ *
+ * 支持嵌套对象脱敏：`*.apiKey` 匹配任意层级的 apiKey 字段
+ */
+const PINO_REDACT_PATHS = [
+    'apiKey', 'token', 'password', 'secret', 'authorization', 'credential',
+    '*.apiKey', '*.token', '*.password', '*.secret',
+    '*.authorization', '*.credential',
+    '*.*.apiKey', '*.*.token', '*.*.password', '*.*.secret',
+];
+/**
+ * 对象脱敏：深拷贝对象并将敏感键的值替换为 [REDACTED]
+ *
+ * 仅用于 console fallback logger 的 JSON.stringify 路径，
+ * 防止 API Key 等敏感数据泄漏到 stderr。
+ */
+function redactSensitiveKeys(obj) {
+    const redacted = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (SENSITIVE_KEY_PATTERN.test(key)) {
+            redacted[key] = '[REDACTED]';
+        }
+        else if (value && typeof value === 'object' && !Array.isArray(value)) {
+            redacted[key] = redactSensitiveKeys(value);
+        }
+        else {
+            redacted[key] = value;
+        }
+    }
+    return redacted;
+}
+/** 是否生产环境 */
+const isProd = process.env['NODE_ENV'] === 'production';
+/** 是否启用文件日志 */
+const fileEnabled = process.env['MEMORA_LOG_FILE'] !== '0';
+/** 日志级别优先级（用于 console fallback 的级别过滤） */
+const LEVEL_PRIORITY = {
+    trace: 0,
+    debug: 1,
+    info: 2,
+    warn: 3,
+    error: 4,
+    fatal: 5,
+    silent: 6,
+};
+/** 判断目标级别是否满足最低级别要求 */
+function shouldLog(targetLevel) {
+    return (LEVEL_PRIORITY[targetLevel] ?? 2) >= (LEVEL_PRIORITY[level] ?? 2);
+}
+/**
+ * Console 零依赖 fallback logger
+ *
+ * pino 不可用时使用。仅输出到 stderr，不写文件。
+ * 满足 ILogger 接口，所有内核模块透明使用。
+ */
+function createConsoleLogger() {
+    return {
+        info: (objOrMsg, msg) => {
+            if (!shouldLog('info'))
+                return;
+            const text = typeof objOrMsg === 'string' ? objOrMsg : msg ?? '';
+            if (typeof objOrMsg === 'object') {
+                console.error(`[INFO] ${text}`, JSON.stringify(redactSensitiveKeys(objOrMsg)));
+            }
+            else {
+                console.error(`[INFO] ${text}`);
+            }
+        },
+        warn: (objOrMsg, msg) => {
+            if (!shouldLog('warn'))
+                return;
+            const text = typeof objOrMsg === 'string' ? objOrMsg : msg ?? '';
+            if (typeof objOrMsg === 'object') {
+                console.error(`[WARN] ${text}`, JSON.stringify(redactSensitiveKeys(objOrMsg)));
+            }
+            else {
+                console.error(`[WARN] ${text}`);
+            }
+        },
+        error: (objOrMsg, msg) => {
+            if (!shouldLog('error'))
+                return;
+            const text = typeof objOrMsg === 'string' ? objOrMsg : msg ?? '';
+            if (typeof objOrMsg === 'object') {
+                console.error(`[ERROR] ${text}`, JSON.stringify(redactSensitiveKeys(objOrMsg)));
+            }
+            else {
+                console.error(`[ERROR] ${text}`);
+            }
+        },
+        debug: (objOrMsg, msg) => {
+            if (!shouldLog('debug'))
+                return;
+            const text = typeof objOrMsg === 'string' ? objOrMsg : msg ?? '';
+            if (typeof objOrMsg === 'object') {
+                console.error(`[DEBUG] ${text}`, JSON.stringify(redactSensitiveKeys(objOrMsg)));
+            }
+            else {
+                console.error(`[DEBUG] ${text}`);
+            }
+        },
+    };
+}
+/**
+ * pino → ILogger 包装器
+ *
+ * pino 通过动态 import 加载，实例类型未知。
+ * 包装器显式提取 4 个日志方法，避免 as unknown as ILogger 双重断言。
+ *
+ * @param pinoInst pino 实例（动态导入）
+ * @returns ILogger 兼容对象
+ */
+function wrapPinoAsLogger(pinoInst) {
+    return {
+        info: pinoInst.info.bind(pinoInst),
+        warn: pinoInst.warn.bind(pinoInst),
+        error: pinoInst.error.bind(pinoInst),
+        debug: pinoInst.debug.bind(pinoInst),
+    };
+}
+/**
+ * 尝试创建 Pino logger
+ *
+ * pino 为可选 peerDependency，通过动态 import 加载。
+ * 加载失败（宿主未安装 pino）则回退到 console logger。
+ *
+ * @returns Pino logger 实例，或 null（pino 不可用）
+ */
+async function tryCreatePinoLogger() {
+    try {
+        const pino = (await import('pino')).default;
+        const { resolve } = await import('node:path');
+        const { mkdirSync, createWriteStream } = await import('node:fs');
+        const { expandHome } = await import('../utils/path.js');
+        const dataDir = process.env['MEMORA_DATA_DIR'] ?? '~/.memora';
+        const resolvedDataDir = resolve(expandHome(dataDir));
+        // pino.StreamEntry 类型在 pino 未安装时不可用，用内联类型
+        const streams = [];
+        // stderr 流（开发环境友好显示）
+        if (!isProd) {
+            streams.push({ level: 'info', stream: process.stderr });
+        }
+        // 文件流（结构化 JSON，方便后续分析）
+        // SEC-06: 日志轮转保护——超过 10MB 时截断重写，防止长期运行生成巨大文件
+        if (fileEnabled) {
+            try {
+                const logsDir = resolve(resolvedDataDir, 'logs');
+                mkdirSync(logsDir, { recursive: true });
+                const logFilePath = resolve(logsDir, 'memora.log');
+                // 检查文件大小，超过 10MB 时截断
+                const LOG_MAX_BYTES = 10 * 1024 * 1024; // 10MB
+                try {
+                    const stat = statSync(logFilePath);
+                    if (stat.size > LOG_MAX_BYTES) {
+                        truncateSync(logFilePath, 0);
+                        process.stderr.write(`[memora] 日志文件超过 10MB，已截断：${logFilePath}\n`);
+                    }
+                }
+                catch (err) {
+                    // 文件不存在或无法 stat，正常——首次写入
+                    if (process.env['MEMORA_DEBUG'])
+                        process.stderr.write(`[memora] stat 日志文件失败：${errMsg(err)}\n`);
+                }
+                streams.push({
+                    level: 'info',
+                    stream: createWriteStream(logFilePath, { flags: 'a' }),
+                });
+            }
+            catch (err) {
+                process.stderr.write(`[memora] 日志文件创建失败：${errMsg(err)}\n`);
+            }
+        }
+        if (streams.length === 0) {
+            // 通过包装器适配 ILogger 接口，避免 as unknown as ILogger 双重断言
+            // SEC-AUDIT: 配置 redact 防止敏感信息写入日志文件
+            return wrapPinoAsLogger(pino({ level, redact: PINO_REDACT_PATHS }));
+        }
+        // 通过包装器适配 ILogger 接口
+        // SEC-AUDIT: 配置 redact 防止敏感信息写入日志文件
+        return wrapPinoAsLogger(pino({ level, redact: PINO_REDACT_PATHS }, pino.multistream(streams)));
+    }
+    catch (err) {
+        // pino 未安装，回退到 console logger
+        if (process.env['MEMORA_DEBUG'])
+            process.stderr.write(`[memora] pino 加载失败：${errMsg(err)}\n`);
+        return null;
+    }
+}
+/**
+ * 全局日志单例
+ *
+ * 初始化为 console fallback，模块顶层异步尝试加载 pino。
+ * 宿主通过 setLogger() 注入后自动替换。
+ */
+let _logger = createConsoleLogger();
+/** 标记 _logger 是否已被宿主注入（用于 setLogger 覆盖检测） */
+let _loggerInjected = false;
+// 同步初始化 utils 层 logger 桥接（确保 utils 在 pino 异步加载前就有 console fallback）
+setUtilsLogger(_logger);
+// 模块加载时异步尝试升级到 pino（不阻塞模块导入）
+void tryCreatePinoLogger().then((pinoLogger) => {
+    if (pinoLogger) {
+        _logger = pinoLogger;
+        _logger.info({ level, prod: isProd, fileEnabled }, 'logger 启动（pino）');
+    }
+    else {
+        _logger.info({ level, prod: isProd }, 'logger 启动（console fallback，pino 未安装）');
+    }
+    // 桥接注入到 utils 层（utils 运行时不依赖 logging/）
+    setUtilsLogger(_logger);
+});
+/**
+ * 全局日志访问器
+ *
+ * 20+ 个内核模块统一通过此变量输出日志。
+ * 宿主注入自定义 logger 后，所有模块自动使用新实现。
+ */
+export const logger = {
+    get info() {
+        return _logger.info.bind(_logger);
+    },
+    get warn() {
+        return _logger.warn.bind(_logger);
+    },
+    get error() {
+        return _logger.error.bind(_logger);
+    },
+    get debug() {
+        return _logger.debug.bind(_logger);
+    },
+};
+/**
+ * 替换全局日志实现
+ *
+ * 宿主项目在 Agent 初始化前调用此函数注入自定义 logger。
+ * 传入 undefined 则恢复为默认（pino 或 console fallback）。
+ *
+ * 注意：此函数修改全局状态。在单 Agent 模型下（ADR-011），
+ * 同一进程只有一个 Agent 实例，不会冲突。若同一进程创建多个
+ * Agent 实例并分别注入 logger，后者会覆盖前者——此时会输出警告。
+ */
+export function setLogger(newLogger) {
+    if (newLogger) {
+        // 检测覆盖：如果当前 logger 已被宿主注入，且新 logger 不是同一个，说明有多处注入
+        if (_loggerInjected && _logger !== newLogger) {
+            _logger.warn('setLogger 覆盖了已有的自定义 logger（单 Agent 模型下不应出现此情况）');
+        }
+        _loggerInjected = true;
+        _logger = newLogger;
+    }
+    else {
+        // 恢复默认：尝试 pino，否则 console
+        _loggerInjected = false;
+        void tryCreatePinoLogger().then((pinoLogger) => {
+            _logger = pinoLogger ?? createConsoleLogger();
+            // 桥接注入到 utils 层
+            setUtilsLogger(_logger);
+        });
+    }
+    // 同步桥接注入到 utils 层（覆盖异步路径，确保 setLogger 后立即生效）
+    setUtilsLogger(_logger);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logging/logger.js.map

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

package/dist/logging/loggerInterface.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 日志接口 — Memora 内核与日志实现的解耦边界
+ *
+ * 设计目标：
+ *   - 宿主项目可注入自定义日志实现（如 Electron 的 winston/pino 实例）
+ *   - 不注入时使用默认 PinoLogger（零配置）
+ *   - 21 个内核模块通过全局单例 `logger` 访问，无需每次传参
+ *
+ * 日志级别语义（与 pino 对齐）：
+ *   - debug：调试信息（默认不输出）
+ *   - info：正常运行信息
+ *   - warn：非致命警告
+ *   - error：错误（含堆栈信息）
+ *
+ * 签名兼容 pino：支持 `logger.info('msg')` 和 `logger.info({ ctx }, 'msg')`
+ */
+export type LogFn = (objOrMsg: Record<string, unknown> | string, msg?: string) => void;
+/**
+ * 日志接口
+ *
+ * 方法签名与 pino 兼容，实现者可以是：
+ *   - pino 实例（默认）
+ *   - console 包装
+ *   - 自定义日志框架
+ *   - 测试 mock
+ */
+export interface ILogger {
+    info: LogFn;
+    warn: LogFn;
+    error: LogFn;
+    debug: LogFn;
+}
+//# sourceMappingURL=loggerInterface.d.ts.map

package/dist/logging/loggerInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerInterface.d.ts","sourceRoot":"","sources":["../../src/logging/loggerInterface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEvF;;;;;;;;GAQG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;CACd"}

package/dist/logging/loggerInterface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loggerInterface.js.map

package/dist/logging/loggerInterface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerInterface.js","sourceRoot":"","sources":["../../src/logging/loggerInterface.ts"],"names":[],"mappings":""}

package/dist/memory/inMemoryRelationStore.d.ts

@@ -0,0 +1,51 @@
+/**
+ * InMemoryRelationStore — 内存关系存储测试用实现
+ *
+ * 职责：
+ * - 实现 IMemoryRelationStore 接口，纯内存数组存储
+ * - 用于单元测试和开发环境验证，不持久化
+ * - 与 InMemoryStorage 对齐，提供零 IO 的测试基座
+ *
+ * 设计原则（ADR-014）：
+ * - 零 native 依赖：纯 JS 数组操作
+ * - 幂等添加：sourceId+targetId+type 三元组唯一，重复添加更新 weight/createdAt
+ * - 方向过滤：getRelations 按 direction 参数过滤 sourceId/targetId
+ *
+ * 宿主项目应实现 SqliteRelationStore（依赖 better-sqlite3）用于生产环境。
+ */
+import type { MemoryRelation, RelationDirection } from '../memory/types.js';
+import type { IMemoryRelationStore } from '../memory/relationStore.js';
+export declare class InMemoryRelationStore implements IMemoryRelationStore {
+    /** 关系列表（内存数组，不持久化） */
+    private readonly relations;
+    /**
+     * 添加关系
+     *
+     * 三元组唯一约束：sourceId+targetId+type 已存在时更新 weight/createdAt（幂等）。
+     */
+    addRelation(relation: MemoryRelation): void;
+    /**
+     * 查询某记忆的关系
+     *
+     * direction 控制方向过滤：
+     * - 'outgoing'：sourceId = memoryId
+     * - 'incoming'：targetId = memoryId
+     * - 'both'：合并两个方向并去重（基于对象引用）
+     */
+    getRelations(memoryId: string, direction?: RelationDirection): MemoryRelation[];
+    /**
+     * 按关系类型查询
+     */
+    getRelationsByType(type: string): MemoryRelation[];
+    /**
+     * 获取全部关系
+     */
+    getAllRelations(): MemoryRelation[];
+    /**
+     * 删除指定关系
+     *
+     * sourceId+targetId+type 唯一定位，删除单条关系。
+     */
+    removeRelation(sourceId: string, targetId: string, type: string): void;
+}
+//# sourceMappingURL=inMemoryRelationStore.d.ts.map

package/dist/memory/inMemoryRelationStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inMemoryRelationStore.d.ts","sourceRoot":"","sources":["../../src/memory/inMemoryRelationStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,qBAAa,qBAAsB,YAAW,oBAAoB;IAChE,sBAAsB;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAElD;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAe3C;;;;;;;OAOG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,iBAA0B,GAAG,cAAc,EAAE;IAavF;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAIlD;;OAEG;IACH,eAAe,IAAI,cAAc,EAAE;IAInC;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAQvE"}

package/dist/memory/inMemoryRelationStore.js

@@ -0,0 +1,65 @@
+export class InMemoryRelationStore {
+    /** 关系列表（内存数组，不持久化） */
+    relations = [];
+    /**
+     * 添加关系
+     *
+     * 三元组唯一约束：sourceId+targetId+type 已存在时更新 weight/createdAt（幂等）。
+     */
+    addRelation(relation) {
+        const existingIdx = this.relations.findIndex((r) => r.sourceId === relation.sourceId &&
+            r.targetId === relation.targetId &&
+            r.type === relation.type);
+        if (existingIdx >= 0) {
+            // 幂等更新：保留原位置，覆盖 weight 和 createdAt
+            this.relations[existingIdx] = { ...relation };
+        }
+        else {
+            this.relations.push({ ...relation });
+        }
+    }
+    /**
+     * 查询某记忆的关系
+     *
+     * direction 控制方向过滤：
+     * - 'outgoing'：sourceId = memoryId
+     * - 'incoming'：targetId = memoryId
+     * - 'both'：合并两个方向并去重（基于对象引用）
+     */
+    getRelations(memoryId, direction = 'both') {
+        if (direction === 'outgoing') {
+            return this.relations.filter((r) => r.sourceId === memoryId).map((r) => ({ ...r }));
+        }
+        if (direction === 'incoming') {
+            return this.relations.filter((r) => r.targetId === memoryId).map((r) => ({ ...r }));
+        }
+        // 'both'：合并两个方向（每条关系最多匹配一次，无需去重）
+        return this.relations
+            .filter((r) => r.sourceId === memoryId || r.targetId === memoryId)
+            .map((r) => ({ ...r }));
+    }
+    /**
+     * 按关系类型查询
+     */
+    getRelationsByType(type) {
+        return this.relations.filter((r) => r.type === type).map((r) => ({ ...r }));
+    }
+    /**
+     * 获取全部关系
+     */
+    getAllRelations() {
+        return this.relations.map((r) => ({ ...r }));
+    }
+    /**
+     * 删除指定关系
+     *
+     * sourceId+targetId+type 唯一定位，删除单条关系。
+     */
+    removeRelation(sourceId, targetId, type) {
+        const idx = this.relations.findIndex((r) => r.sourceId === sourceId && r.targetId === targetId && r.type === type);
+        if (idx >= 0) {
+            this.relations.splice(idx, 1);
+        }
+    }
+}
+//# sourceMappingURL=inMemoryRelationStore.js.map

package/dist/memory/inMemoryRelationStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inMemoryRelationStore.js","sourceRoot":"","sources":["../../src/memory/inMemoryRelationStore.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,qBAAqB;IAChC,sBAAsB;IACL,SAAS,GAAqB,EAAE,CAAC;IAElD;;;;OAIG;IACH,WAAW,CAAC,QAAwB;QAClC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAC1C,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;YAChC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;YAChC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAC3B,CAAC;QACF,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YACrB,mCAAmC;YACnC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,QAAgB,EAAE,YAA+B,MAAM;QAClE,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACtF,CAAC;QACD,iCAAiC;QACjC,OAAO,IAAI,CAAC,SAAS;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC;aACjE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,QAAgB,EAAE,QAAgB,EAAE,IAAY;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAC7E,CAAC;QACF,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;CACF"}

package/dist/memory/inMemoryStorage.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 内存存储实现 — IMemoryStorage 的纯 JS 内存实现
+ *
+ * 零依赖、零 IO，适用于：
+ * - 单元测试（不需要 better-sqlite3，不需要文件系统）
+ * - 宿主项目注入前的临时占位
+ * - 沙箱/演示环境
+ *
+ * 注意：此实现不持久化，进程退出后数据丢失。
+ * ⚠️ 仅限测试/开发使用，生产环境请注入 SqliteStorage（宿主项目提供）。
+ */
+import type { IMemoryStorage } from '../memory/storageInterface.js';
+import type { Memory } from '../memory/types.js';
+/**
+ * 内存存储实现
+ *
+ * 使用 Map 存储记忆，核心操作 O(1)~O(log n)。
+ * P2-2 优化：维护 source→count 增量缓存，stats()/sourceHealth() 无需全量遍历。
+ */
+export declare class InMemoryStorage implements IMemoryStorage {
+    /** 记忆存储（id → Memory） */
+    private memories;
+    /** P2-2 source→count 增量缓存（upsert/delete 时维护，getAllSources 时直接读取） */
+    private sourceCountCache;
+    /**
+     * 插入或更新记忆
+     *
+     * 自动校验 source 字段，对疑似 typo 发出警告日志。
+     * P2-2 增量维护 sourceCountCache：更新时旧 source 减 1、新 source 加 1。
+     */
+    upsert(memory: Memory): void;
+    /**
+     * 删除记忆
+     *
+     * P2-2 增量维护 sourceCountCache：删除时对应 source 减 1。
+     */
+    delete(id: string): void;
+    /**
+     * 按 ID 获取单条记忆
+     *
+     * 返回浅拷贝，避免调用方修改污染存储内部对象（接口契约：读取隔离）
+     */
+    getById(id: string): Memory | null;
+    /**
+     * 按来源标签获取记忆
+     *
+     * 返回浅拷贝数组，避免调用方修改污染存储内部对象。
+     *
+     * @param source - 来源标签（如 'persona'、'rule'、'insight'）
+     * @returns 该来源的所有记忆（副本），按 score 降序排列
+     */
+    getBySource(source: string): Memory[];
+    /**
+     * 文本搜索（内存版）
+     *
+     * 使用 segmentText() 规范分词，与 SqliteStorage 行为一致。
+     * 搜索 content 和 name 字段，按 score 降序排列。
+     *
+     * @param query - 搜索查询文本
+     * @param limit - 返回数量上限（默认 10）
+     * @returns 匹配的记忆列表
+     */
+    search(query: string, limit?: number): Memory[];
+    /**
+     * 统计记忆总数
+     */
+    count(): number;
+    /**
+     * 按来源标签统计记忆数量
+     *
+     * P2-2 优化：直接读取 sourceCountCache，O(1) 复杂度（与 getAllSources 一致）
+     * 原实现 O(n) 遍历所有记忆，与增量缓存设计不一致
+     */
+    countBySource(source: string): number;
+    /**
+     * 衰减指定来源的记忆 score
+     *
+     * 遍历所有匹配 source 的记忆，按时间衰减。
+     * 生产环境宿主（SqliteStorage）应重写为 SQL UPDATE 批量操作。
+     */
+    decayScores(sources: string[], now: Date): number;
+    /**
+     * 获取所有 source 标签及其记忆数量
+     *
+     * P2-2 优化：直接读取增量维护的 sourceCountCache，O(1) 复杂度。
+     */
+    getAllSources(): Map<string, number>;
+    /**
+     * 关闭（内存实现无需关闭）
+     */
+    close(): void;
+    /** source 计数 +1 */
+    private incrementSourceCount;
+    /** source 计数 -1（减至 0 时移除键） */
+    private decrementSourceCount;
+}
+//# sourceMappingURL=inMemoryStorage.d.ts.map

package/dist/memory/inMemoryStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inMemoryStorage.d.ts","sourceRoot":"","sources":["../../src/memory/inMemoryStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMhD;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,cAAc;IACpD,wBAAwB;IACxB,OAAO,CAAC,QAAQ,CAAkC;IAElD,oEAAoE;IACpE,OAAO,CAAC,gBAAgB,CAAkC;IAE1D;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAqB5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKlC;;;;;;;OAOG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAOrC;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,EAAE;IAiC3C;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIrC;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM;IAWjD;;;;OAIG;IACH,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIpC;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb,mBAAmB;IACnB,OAAO,CAAC,oBAAoB;IAI5B,8BAA8B;IAC9B,OAAO,CAAC,oBAAoB;CAS7B"}