@zooique/memora 2.0.3 → 3.0.0

package/dist/memory/recall.d.ts

@@ -1,82 +0,0 @@
-/**
- * 记忆召回 — 简化关键词搜索
- *
- * 设计哲学：每次用户发消息，从所有记忆中搜索最相关的几条注入上下文
- * 基于基元驱动模型，通过 source 开放字符串区分记忆来源，
- * 通过双通道（语义 + 关键词）召回，无需独立管理器
- *
- * 双通道融合排序算法在 hybridMerge.ts 中实现，与 memoryInspector.searchHybrid() 共享。
- *
- * 详见 ADR-004 · 记忆统一模型 + architecture_philosophy_rules.md §6 增量召回
- */
-import type { Memory } from '../memory/types.js';
-import type { IMemoryStorage } from '../memory/storageInterface.js';
-import type { IVectorStore } from '../memory/vectorStore.js';
-/** 一天对应的毫秒数 */
-export declare const ONE_DAY_MS: number;
-/**
- * 从文本中提取关键词（用于记忆召回）
- *
- * 基于 segmentText() 精确分词，叠加停用词过滤 + 英文词补充 + 去重。
- * 分词基础设施统一由 segmenter.ts 提供，避免重复实现。
- *
- * @param input - 输入文本
- * @returns 关键词数组（去重 + 停用词过滤）
- */
-export declare function extractKeywords(input: string): string[];
-/**
- * 召回选项
- */
-export interface RecallOptions {
-    /** 返回数量上限（默认 5） */
-    limit?: number;
-    /** 排除的 source 标签（默认排除 persona、rule、skill——已单独注入 system prompt 的记忆） */
-    excludeSources?: string[];
-    /** 向量存储（可选，提供时启用语义搜索；接受任意 IVectorStore 实现） */
-    vectorStore?: IVectorStore;
-    /** 语义搜索相似度阈值（默认 0.3） */
-    minSimilarity?: number;
-}
-/**
- * 从记忆存储中搜索相关记忆
- *
- * 双通道召回策略：
- * 1. 语义搜索（VectorStore 可用时）：向量余弦相似度
- * 2. 关键词搜索（兜底）：LIKE 匹配
- * 3. 两路结果合并去重，按 score + similarity 综合排序（委托给 hybridMerge）
- * 4. 排除已单独注入的记忆（persona、rule、skill）
- * 5. 返回 top N
- *
- * 融合排序算法已提取到 hybridMerge.ts，与 searchHybrid() 共享同一实现
- *
- * @param storage - 记忆存储实例
- * @param query - 搜索查询文本
- * @param options - 召回选项
- * @returns 匹配的记忆列表
- */
-export declare function recall(storage: IMemoryStorage, query: string, options?: RecallOptions): Promise<Memory[]>;
-/**
- * 批量持久化 boost 后的 score（FIX-P1-2：从 recall() 拆分出的显式写操作）
- *
- * 调用方在 recall() 后 fire-and-forget 调用本函数持久化 boost，不阻塞读路径。
- * 失败仅 log 不抛错，避免读路径因 boost 写入失败而中断。
- *
- * 设计权衡：
- *   - 不在 recall() 内部 upsert：消除 IO 写耦合读路径（boost 是软指标，丢失影响小）
- *   - 不引入 dirty 标记 + 治理调度器批量持久化：避免新增状态队列和跨模块依赖
- *   - 立即持久化但 fire-and-forget：boost 数据不丢，读路径不阻塞
- *
- * @param storage 记忆存储实例
- * @param ids 待 boost 的记忆 id 列表（从 recall() 返回结果的 id 字段提取）
- * @param now 当前时间戳（可选，默认 nowIso()）
- */
-export declare function boostScores(storage: IMemoryStorage, ids: string[], now?: string): Promise<void>;
-/**
- * 对单条记忆执行衰减计算
- *
- * @param memory - 要衰减的记忆
- * @param now - 当前时间（Date 对象）
- * @returns 是否实际发生了衰减
- */
-export declare function applyDecayToMemory(memory: Memory, now: Date): boolean;
-//# sourceMappingURL=recall.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/memory/recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAe5D,eAAe;AACf,eAAO,MAAM,UAAU,QAAsB,CAAC;AAE9C;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAUvD;AAID;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,wBAAwB;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,MAAM,CAC1B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CA+DnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,MAAM,EAAE,EACb,GAAG,GAAE,MAAiB,GACrB,OAAO,CAAC,IAAI,CAAC,CAOf;AAkBD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAcrE"}

package/dist/memory/recall.js

@@ -1,157 +0,0 @@
-import { logger } from '../logging/logger.js';
-import { SOURCE_LABELS } from '../memory/types.js';
-import { segmentLower, STOPWORDS } from '../utils/segmenter.js';
-import { nowIso } from '../utils/time.js';
-import { hybridMerge, RECALL_LIMIT_MULTIPLIER } from '../memory/hybridMerge.js';
-// 召回 score 提升量/上限/下限 + 衰减常量：使用治理共享常量（v2 REPEAT-2/REPEAT-3 闭环）
-// 衰减常量与宿主 SqliteStorage.decayScores 共用同一真理源，消除跨层重复硬编码
-import { BOOST_INCREMENT, SCORE_CEILING, DECAY_FLOOR, DECAY_AGE_DAYS, DECAY_AMOUNT } from '../memory/governance.js';
-// ─── 召回常量 ─────────────────────────────────────
-/** 语义搜索默认相似度阈值 */
-const DEFAULT_MIN_SIMILARITY = 0.3;
-/** 一天对应的毫秒数 */
-export const ONE_DAY_MS = 24 * 60 * 60 * 1000;
-/**
- * 从文本中提取关键词（用于记忆召回）
- *
- * 基于 segmentText() 精确分词，叠加停用词过滤 + 英文词补充 + 去重。
- * 分词基础设施统一由 segmenter.ts 提供，避免重复实现。
- *
- * @param input - 输入文本
- * @returns 关键词数组（去重 + 停用词过滤）
- */
-export function extractKeywords(input) {
-    // 复用 segmenter.ts 的精确分词（Intl.Segmenter ICU 词典切分）
-    const words = segmentLower(input);
-    // 补充英文词（segmentText 可能遗漏连续英文大写缩写，如 APIKey → "apikey" 整词）
-    const englishWords = input.match(/[a-z]{2,}/gi) || [];
-    words.push(...englishWords.map((w) => w.toLowerCase()));
-    // 去重 + 停用词过滤 + 最短长度
-    return [...new Set(words)].filter((w) => w.length >= 2 && !STOPWORDS.has(w));
-}
-/**
- * 从记忆存储中搜索相关记忆
- *
- * 双通道召回策略：
- * 1. 语义搜索（VectorStore 可用时）：向量余弦相似度
- * 2. 关键词搜索（兜底）：LIKE 匹配
- * 3. 两路结果合并去重，按 score + similarity 综合排序（委托给 hybridMerge）
- * 4. 排除已单独注入的记忆（persona、rule、skill）
- * 5. 返回 top N
- *
- * 融合排序算法已提取到 hybridMerge.ts，与 searchHybrid() 共享同一实现
- *
- * @param storage - 记忆存储实例
- * @param query - 搜索查询文本
- * @param options - 召回选项
- * @returns 匹配的记忆列表
- */
-export async function recall(storage, query, options = {}) {
-    const { limit = 5, excludeSources = [SOURCE_LABELS.PERSONA, SOURCE_LABELS.RULE, SOURCE_LABELS.SKILL], vectorStore, minSimilarity = DEFAULT_MIN_SIMILARITY, } = options;
-    const merged = new Map();
-    // ── 通道 1：语义搜索（VectorStore 可用时） ──
-    if (vectorStore && vectorStore.size > 0) {
-        try {
-            const vectorResults = await vectorStore.search(query, limit * RECALL_LIMIT_MULTIPLIER, minSimilarity);
-            for (const vr of vectorResults) {
-                const memory = storage.getById(vr.id);
-                if (memory && !excludeSources.includes(memory.source)) {
-                    merged.set(memory.id, { memory, vectorScore: vr.similarity });
-                }
-            }
-        }
-        catch (err) {
-            logger.debug({ err }, '语义搜索失败，降级到关键词');
-        }
-    }
-    // ── 通道 2：关键词搜索 ──
-    const keywords = extractKeywords(query);
-    if (keywords.length > 0) {
-        // 关键词搜索失败时降级返回已收集的语义结果，与通道 1 降级策略对称
-        try {
-            // 使用提取后的关键词组合搜索，避免原始 query 中的停用词/噪声影响匹配
-            const keywordResults = storage.search(keywords.join(' '), limit * RECALL_LIMIT_MULTIPLIER);
-            for (const m of keywordResults) {
-                if (!excludeSources.includes(m.source) && !merged.has(m.id)) {
-                    merged.set(m.id, { memory: m, vectorScore: 0 });
-                }
-            }
-        }
-        catch (err) {
-            logger.debug({ err }, '关键词搜索失败，仅返回语义搜索结果');
-        }
-    }
-    // ── 无任何结果 ──
-    if (merged.size === 0)
-        return [];
-    // ── 综合排序：委托给 hybridMerge 纯函数 ──
-    const sorted = hybridMerge(merged.values(), limit);
-    // ── FIX-P1-2：拆分读/写，recall 只读 + boostScores 显式写 ──
-    // 在副本上 boost，仅影响本轮上下文排序；持久化由调用方 fire-and-forget 调用 boostScores，
-    // 不阻塞读路径，boost 写入失败不影响 chat 流程。
-    const now = nowIso();
-    const result = sorted.map(({ memory }) => {
-        const copy = { ...memory };
-        boostScore(copy, now);
-        return copy;
-    });
-    return result;
-}
-/**
- * 批量持久化 boost 后的 score（FIX-P1-2：从 recall() 拆分出的显式写操作）
- *
- * 调用方在 recall() 后 fire-and-forget 调用本函数持久化 boost，不阻塞读路径。
- * 失败仅 log 不抛错，避免读路径因 boost 写入失败而中断。
- *
- * 设计权衡：
- *   - 不在 recall() 内部 upsert：消除 IO 写耦合读路径（boost 是软指标，丢失影响小）
- *   - 不引入 dirty 标记 + 治理调度器批量持久化：避免新增状态队列和跨模块依赖
- *   - 立即持久化但 fire-and-forget：boost 数据不丢，读路径不阻塞
- *
- * @param storage 记忆存储实例
- * @param ids 待 boost 的记忆 id 列表（从 recall() 返回结果的 id 字段提取）
- * @param now 当前时间戳（可选，默认 nowIso()）
- */
-export async function boostScores(storage, ids, now = nowIso()) {
-    for (const id of ids) {
-        // MIND2-L3：改用 incrementScore 原子操作，消除 read-modify-write 并发冲突
-        // 原 getById → boostScore → upsert 三步合并为存储层一条原子更新，
-        // 与 decayScores 同模式（避免与衰减/去重并发写时基于旧值覆盖）
-        storage.incrementScore(id, BOOST_INCREMENT, now);
-    }
-}
-// ─── Score 衰减机制 ─────────────────────────────────────
-/**
- * 召回时提升记忆的 score（上限 1.0）
- *
- * 每次被召回时，记忆的 score 略微提升，体现"越常用越重要"。
- *
- * @param memory - 被召回的记忆
- * @param now - 当前时间戳（ISO 8601）
- */
-// 模块私有（0 外部消费者，仅 recall.ts 内部调用，与 tokenizeKeywords 同模式）
-function boostScore(memory, now) {
-    memory.score = Math.min(SCORE_CEILING, memory.score + BOOST_INCREMENT);
-    memory.accessedAt = now ?? nowIso();
-}
-/**
- * 对单条记忆执行衰减计算
- *
- * @param memory - 要衰减的记忆
- * @param now - 当前时间（Date 对象）
- * @returns 是否实际发生了衰减
- */
-export function applyDecayToMemory(memory, now) {
-    const accessedAt = new Date(memory.accessedAt);
-    if (isNaN(accessedAt.getTime())) {
-        return false; // 跳过无效日期的记忆
-    }
-    const daysSinceAccess = (now.getTime() - accessedAt.getTime()) / ONE_DAY_MS;
-    if (daysSinceAccess <= DECAY_AGE_DAYS) {
-        return false;
-    }
-    const periods = Math.floor(daysSinceAccess / DECAY_AGE_DAYS);
-    memory.score = Math.max(DECAY_FLOOR, memory.score - DECAY_AMOUNT * periods);
-    return true;
-}
-//# sourceMappingURL=recall.js.map

package/dist/memory/recall.js.map

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

package/dist/memory/relationStore.d.ts

@@ -1,95 +0,0 @@
-/**
- * 记忆关系存储接口 — 独立于 IMemoryStorage 的侧车接口
- *
- * 设计原则（ADR-014）：
- * - 侧车模型：不侵入 Memory 7 字段基元，与 IMemoryStorage 平行存在
- * - 接口注入：内核提供接口，宿主项目注入实现（如 SqliteRelationStore）
- * - 零 native 依赖：内核不依赖 better-sqlite3 等 native 模块
- *
- * 宿主项目实现示例：
- * - SqliteRelationStore：扩展 memory_relations 表，依赖 better-sqlite3
- * - InMemoryRelationStore：测试用实现，纯内存数组
- *
- * 关系构建时机与层属（ADR-014 §5）：
- * - 机制层（候选召回 + prompt 构建 + 关系写入 + 冲突检测）在内核
- *   src/agent/managers/relationBuilder.ts，LLM 调用合并到 InsightExtractor
- *   单次 extract() 中，不增加 LLM 调用次数
- * - 宿主项目（Sprite 层）仅需注入 IMemoryRelationStore 实现
- * - 遵循降级优先（ADR-006）：关系构建失败不阻塞对话，仅记录日志
- */
-import type { MemoryRelation, RelationDirection } from '../memory/types.js';
-/**
- * 记忆关系存储接口（侧车）
- *
- * 独立于 IMemoryStorage，不依赖 Memory 7 字段。
- * 宿主项目实现此接口并注入 Agent，用于：
- * - 冲突检测：getRelationsByType('contradicts')
- * - 召回增强：getRelations(memoryId, 'both')
- * - 拓扑可视化：getAllRelations()
- */
-export interface IMemoryRelationStore {
-    /**
-     * 添加关系
-     *
-     * sourceId+targetId+type 三元组唯一约束，重复添加应幂等（更新 weight/createdAt 或忽略）。
-     *
-     * @param relation 关系数据（sourceId/targetId/type/weight/createdAt）
-     */
-    addRelation(relation: MemoryRelation): void;
-    /**
-     * 查询某记忆的关系
-     *
-     * @param memoryId 记忆 ID
-     * @param direction 方向过滤（默认 'both'）：
-     *   - 'outgoing'：只查 sourceId = memoryId 的关系（冲突检测用）
-     *   - 'incoming'：只查 targetId = memoryId 的关系
-     *   - 'both'：合并两个方向并去重（可视化/召回增强用）
-     * @returns 匹配的关系列表
-     */
-    getRelations(memoryId: string, direction?: RelationDirection): MemoryRelation[];
-    /**
-     * 按关系类型查询
-     *
-     * 用于冲突检测：getRelationsByType('contradicts') 获取所有矛盾关系。
-     *
-     * @param type 关系类型（开放字符串，如 'contradicts'/'supports'/'follows'）
-     * @returns 匹配的关系列表
-     */
-    getRelationsByType(type: string): MemoryRelation[];
-    /**
-     * 获取全部关系
-     *
-     * 用于拓扑可视化构建节点+边图谱。
-     * 数据量大时（>10000）可改为分页，但 Phase 1 不需要。
-     *
-     * @returns 全部关系列表
-     */
-    getAllRelations(): MemoryRelation[];
-    /**
-     * 删除指定关系
-     *
-     * sourceId+targetId+type 唯一定位，删除单条关系。
-     * 用于关系修正（用户确认冲突后删除误判关系）。
-     *
-     * @param sourceId 关系起点
-     * @param targetId 关系终点
-     * @param type 关系类型
-     */
-    removeRelation(sourceId: string, targetId: string, type: string): void;
-    /**
-     * 删除某记忆的所有关系（不论方向）
-     *
-     * 删除 sourceId 或 targetId 等于 memoryId 的所有关系边。
-     * 用于记忆删除/物理清除场景，防止 memory_relations 表残留孤儿边。
-     *
-     * 实现约束：
-     * - 必须原子执行（单条 SQL DELETE WHERE sourceId=? OR targetId=?）
-     * - 返回被删除的关系数量，便于审计
-     * - 不存在的 memoryId 返回 0，不抛错
-     *
-     * @param memoryId 记忆 ID
-     * @returns 被删除的关系数量
-     */
-    removeRelationsByMemoryId(memoryId: string): number;
-}
-//# sourceMappingURL=relationStore.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"relationStore.d.ts","sourceRoot":"","sources":["../../src/memory/relationStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAE5C;;;;;;;;;OASG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAAC;IAEhF;;;;;;;OAOG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;IAEnD;;;;;;;OAOG;IACH,eAAe,IAAI,cAAc,EAAE,CAAC;IAEpC;;;;;;;;;OASG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvE;;;;;;;;;;;;;OAaG;IACH,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CACrD"}

package/dist/memory/relationStore.js

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

package/dist/memory/relationStore.js.map

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

package/dist/memory/store.d.ts

@@ -1,71 +0,0 @@
-import { type Memory } from '../memory/types.js';
-/**
- * 文件存储类
- *
- * 每个 source 对应一个子目录（personas/rules/skills/…）
- * 读取时通过 inferSource() 从文件路径推断 source
- */
-export declare class FileStore {
-    private readonly dataDir;
-    constructor(dataDir: string);
-    /**
-     * 读取记忆文件
-     *
-     * @param source - 来源标签（如 'rule'、'persona'）
-     * @param name - 记忆名（不含扩展名）
-     */
-    read(source: string, name: string): Promise<Memory | null>;
-    /**
-     * 写入记忆文件
-     *
-     * frontmatter 包含标准字段（id/source/score/createdAt/accessedAt）
-     * 和 memory.metadata 中的额外元数据（如 keywords/description）。
-     */
-    write(memory: Memory): Promise<void>;
-    /**
-     * 列出某个 source 下的所有记忆
-     *
-     * @param source - 来源标签（如 'rule'、'persona'）
-     * @returns 记忆名称列表（不含扩展名）
-     */
-    list(source: string): Promise<string[]>;
-    /**
-     * 获取文件路径
-     */
-    private getFilePath;
-    /**
-     * source 到目录名的映射
-     *
-     * 已知 source 使用预定义目录，未知 source 直接用 source 字符串作目录名。
-     * 安全校验：调用 validateSource 拒绝路径遍历（`..`）、null 字节等危险字符，
-     * 防止未知 source 被构造为恶意路径绕过 SOURCE_TO_DIR 白名单。
-     */
-    private sourceToDir;
-    /**
-     * 文件系统错误统一处理
-     *
-     * 区分两类错误：
-     *   - ENOENT（文件/目录不存在）：正常情况，静默返回
-     *   - 其他错误（EACCES/EISDIR 等）：真实故障，抛出异常让调用方感知
-     *
-     * 之前所有错误统一返回 null/[]，导致磁盘故障伪装成"无数据"，
-     * 用户感知不到数据丢失。现区分：ENOENT 静默，其他抛错。
-     *
-     * @param err 捕获的异常
-     * @param path 文件/目录路径（用于日志上下文）
-     * @param label 日志标签（中文，如 "记忆文件读取失败"）
-     * @throws {NodeJS.ErrnoException} 非 ENOENT 错误时重新抛出
-     */
-    private handleFsError;
-    /**
-     * 解析记忆文件为 Memory 对象
-     *
-     * @param source - 来源标签
-     * @param name - 记忆名
-     * @param raw - 文件原始内容
-     * @param filePath - 文件路径（用于 inferSource 回退）
-     * @param mtime - 文件修改时间
-     */
-    private parseMemory;
-}
-//# sourceMappingURL=store.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAQA,OAAO,EAAuC,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAmBrF;;;;;GAKG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAE5C;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkBhE;;;;;OAKG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB1C;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAc7C;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAanB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,aAAa;IAWrB;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;CA4CpB"}

package/dist/memory/store.js

@@ -1,199 +0,0 @@
-/**
- * 记忆文件存储
- *
- * 冷热分离中的"热"：文件承载记忆本体
- * 详见 ADR-002 · IMemoryStorage 接口与宿主注入模式
- */
-import { readFile, writeFile, mkdir, readdir, stat } from 'node:fs/promises';
-import { join, dirname } from 'node:path';
-import { SOURCE_LABELS, DEFAULT_MEMORY_SCORE } from '../memory/types.js';
-import { inferSource, validateSource } from '../memory/sourceValidation.js';
-import { parseFrontmatter, serializeFrontmatter as serializeFm } from '../utils/frontmatter.js';
-import { logger } from '../logging/logger.js';
-import { toError } from '../utils/toError.js';
-import { configError } from '../utils/errors.js';
-/**
- * 已知 source 到文件系统目录的映射
- *
- * 仅覆盖配置类记忆（启动时扫描的 persona/rule/skill）；
- * 运行时产生的记忆（insight/profile/work-projection）不由 FileStore 管理
- */
-const SOURCE_TO_DIR = {
-    [SOURCE_LABELS.PERSONA]: 'personas',
-    [SOURCE_LABELS.RULE]: 'rules',
-    [SOURCE_LABELS.SKILL]: 'skills',
-};
-/**
- * 文件存储类
- *
- * 每个 source 对应一个子目录（personas/rules/skills/…）
- * 读取时通过 inferSource() 从文件路径推断 source
- */
-export class FileStore {
-    dataDir;
-    constructor(dataDir) {
-        this.dataDir = dataDir;
-    }
-    /**
-     * 读取记忆文件
-     *
-     * @param source - 来源标签（如 'rule'、'persona'）
-     * @param name - 记忆名（不含扩展名）
-     */
-    async read(source, name) {
-        const filePath = this.getFilePath(source, name);
-        // 异步读取：文件不存在时 readFile 抛 ENOENT，handleFsError 对 ENOENT 静默返回（read 返回 null）
-        // 其他错误（EACCES/EISDIR 等）由 handleFsError 重新抛出，让调用方感知故障
-        let content;
-        let fileStat;
-        try {
-            content = await readFile(filePath, 'utf-8');
-            fileStat = await stat(filePath);
-        }
-        catch (err) {
-            this.handleFsError(err, filePath, '记忆文件读取失败');
-            return null; // 仅 ENOENT 到达此处（其他错误已在 handleFsError 抛出）
-        }
-        // 从文件路径推断 source（frontmatter 可覆盖）
-        return this.parseMemory(source, name, content, filePath, fileStat.mtime);
-    }
-    /**
-     * 写入记忆文件
-     *
-     * frontmatter 包含标准字段（id/source/score/createdAt/accessedAt）
-     * 和 memory.metadata 中的额外元数据（如 keywords/description）。
-     */
-    async write(memory) {
-        const filePath = this.getFilePath(memory.source, memory.name);
-        await mkdir(dirname(filePath), { recursive: true });
-        // 标准字段必须优先于 metadata：metadata 中可能含同名键（如恶意的 source='evil'），
-        // 若后展开则劫持 source 语义绕过 sourceValidation。先展开 metadata，再显式覆盖标准字段；
-        // 并过滤掉与标准字段同名的 metadata 键，避免写入重复行（如 source: evil\n source: normal）。
-        const STANDARD_KEYS = new Set(['id', 'source', 'score', 'createdAt', 'accessedAt']);
-        const safeMeta = {};
-        for (const [k, v] of Object.entries(memory.metadata ?? {})) {
-            if (!STANDARD_KEYS.has(k))
-                safeMeta[k] = v;
-        }
-        const frontmatter = serializeFm({
-            ...safeMeta,
-            id: memory.id,
-            source: memory.source,
-            score: String(memory.score),
-            createdAt: memory.createdAt,
-            accessedAt: memory.accessedAt,
-        });
-        const content = `---\n${frontmatter}\n---\n\n${memory.content}`;
-        await writeFile(filePath, content, 'utf-8');
-    }
-    /**
-     * 列出某个 source 下的所有记忆
-     *
-     * @param source - 来源标签（如 'rule'、'persona'）
-     * @returns 记忆名称列表（不含扩展名）
-     */
-    async list(source) {
-        const dir = join(this.dataDir, this.sourceToDir(source));
-        // 异步读取：目录不存在时 readdir 抛 ENOENT，handleFsError 对 ENOENT 静默返回（list 返回 []）
-        // 其他错误由 handleFsError 重新抛出，让调用方感知故障
-        let files;
-        try {
-            files = await readdir(dir);
-        }
-        catch (err) {
-            this.handleFsError(err, dir, '记忆目录读取失败');
-            return []; // 仅 ENOENT 到达此处（其他错误已在 handleFsError 抛出）
-        }
-        return files.filter((f) => f.endsWith('.md')).map((f) => f.replace(/\.md$/, ''));
-    }
-    /**
-     * 获取文件路径
-     */
-    getFilePath(source, name) {
-        return join(this.dataDir, this.sourceToDir(source), `${name}.md`);
-    }
-    /**
-     * source 到目录名的映射
-     *
-     * 已知 source 使用预定义目录，未知 source 直接用 source 字符串作目录名。
-     * 安全校验：调用 validateSource 拒绝路径遍历（`..`）、null 字节等危险字符，
-     * 防止未知 source 被构造为恶意路径绕过 SOURCE_TO_DIR 白名单。
-     */
-    sourceToDir(source) {
-        const result = validateSource(source);
-        if (result.severity === 'block') {
-            // 路径遍历 / null 字节 / 空字符串等安全边界违规，必须拒绝
-            throw configError('source 校验失败，拒绝映射到目录', result.warning, ['检查 source 字段是否包含路径遍历序列或特殊字符']);
-        }
-        return SOURCE_TO_DIR[source] ?? source;
-    }
-    /**
-     * 文件系统错误统一处理
-     *
-     * 区分两类错误：
-     *   - ENOENT（文件/目录不存在）：正常情况，静默返回
-     *   - 其他错误（EACCES/EISDIR 等）：真实故障，抛出异常让调用方感知
-     *
-     * 之前所有错误统一返回 null/[]，导致磁盘故障伪装成"无数据"，
-     * 用户感知不到数据丢失。现区分：ENOENT 静默，其他抛错。
-     *
-     * @param err 捕获的异常
-     * @param path 文件/目录路径（用于日志上下文）
-     * @param label 日志标签（中文，如 "记忆文件读取失败"）
-     * @throws {NodeJS.ErrnoException} 非 ENOENT 错误时重新抛出
-     */
-    handleFsError(err, path, label) {
-        const error = toError(err);
-        if (error.code === 'ENOENT') {
-            // 文件/目录不存在是正常情况（首次启动、新项目等），静默返回
-            return;
-        }
-        // 非 ENOENT 错误：记录警告并重新抛出，让调用方区分"无数据"与"故障"
-        logger.warn({ path, code: error.code, err: error.message }, label);
-        throw error;
-    }
-    /**
-     * 解析记忆文件为 Memory 对象
-     *
-     * @param source - 来源标签
-     * @param name - 记忆名
-     * @param raw - 文件原始内容
-     * @param filePath - 文件路径（用于 inferSource 回退）
-     * @param mtime - 文件修改时间
-     */
-    parseMemory(source, name, raw, filePath, mtime) {
-        const { frontmatter: meta, body } = parseFrontmatter(raw);
-        // 从 frontmatter 读取 source（如有显式声明则覆盖）
-        const resolvedSource = meta['source'] ?? inferSource(filePath, source);
-        // 无 frontmatter 时，使用默认值
-        if (Object.keys(meta).length === 0) {
-            const now = mtime.toISOString();
-            return {
-                id: `${resolvedSource}:${name}`,
-                content: raw,
-                source: resolvedSource,
-                name,
-                createdAt: now,
-                accessedAt: now,
-                score: DEFAULT_MEMORY_SCORE,
-            };
-        }
-        const now = mtime.toISOString();
-        // 修复 #34：校验 score，防止 NaN/越界值违反校验规则（min(0).max(1)）
-        // frontmatter 中 score 字段若为非数字字符串（如 "abc"），Number 返回 NaN 会破坏后续写入
-        const rawScore = Number(meta['score'] ?? DEFAULT_MEMORY_SCORE);
-        const score = Number.isFinite(rawScore) && rawScore >= 0 && rawScore <= 1
-            ? rawScore
-            : DEFAULT_MEMORY_SCORE;
-        return {
-            id: meta['id'] ?? `${resolvedSource}:${name}`,
-            content: body.trim(),
-            source: resolvedSource,
-            name,
-            createdAt: meta['createdAt'] ?? now,
-            accessedAt: meta['accessedAt'] ?? now,
-            score,
-        };
-    }
-}
-//# sourceMappingURL=store.js.map

package/dist/memory/store.js.map

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