@zooique/memora 0.1.0

package/dist/memory/inMemoryStorage.js

@@ -0,0 +1,177 @@
+import { validateSource } from '../memory/types.js';
+import { segmentText } from '../utils/segmenter.js';
+import { logger } from '../logging/logger.js';
+import { applyDecayToMemory } from '../memory/recall.js';
+/**
+ * 内存存储实现
+ *
+ * 使用 Map 存储记忆，核心操作 O(1)~O(log n)。
+ * P2-2 优化：维护 source→count 增量缓存，stats()/sourceHealth() 无需全量遍历。
+ */
+export class InMemoryStorage {
+    /** 记忆存储（id → Memory） */
+    memories = new Map();
+    /** P2-2 source→count 增量缓存（upsert/delete 时维护，getAllSources 时直接读取） */
+    sourceCountCache = new Map();
+    /**
+     * 插入或更新记忆
+     *
+     * 自动校验 source 字段，对疑似 typo 发出警告日志。
+     * P2-2 增量维护 sourceCountCache：更新时旧 source 减 1、新 source 加 1。
+     */
+    upsert(memory) {
+        const result = validateSource(memory.source);
+        if (result.severity === 'block') {
+            throw new Error(`source 校验失败（拒绝写入）：${result.warning}`);
+        }
+        if (result.severity === 'warn' && result.warning) {
+            logger.warn({ id: memory.id, source: memory.source, warning: result.warning }, 'source 校验警告');
+        }
+        // P2-2 增量维护 source 缓存：若为更新（id 已存在），先减旧 source 计数
+        const existing = this.memories.get(memory.id);
+        if (existing && existing.source !== memory.source) {
+            this.decrementSourceCount(existing.source);
+        }
+        this.memories.set(memory.id, { ...memory });
+        // P2-2 增量维护 source 缓存：新 source 加 1
+        this.incrementSourceCount(memory.source);
+    }
+    /**
+     * 删除记忆
+     *
+     * P2-2 增量维护 sourceCountCache：删除时对应 source 减 1。
+     */
+    delete(id) {
+        const existing = this.memories.get(id);
+        if (existing) {
+            this.decrementSourceCount(existing.source);
+        }
+        this.memories.delete(id);
+    }
+    /**
+     * 按 ID 获取单条记忆
+     *
+     * 返回浅拷贝，避免调用方修改污染存储内部对象（接口契约：读取隔离）
+     */
+    getById(id) {
+        const m = this.memories.get(id);
+        return m ? { ...m } : null;
+    }
+    /**
+     * 按来源标签获取记忆
+     *
+     * 返回浅拷贝数组，避免调用方修改污染存储内部对象。
+     *
+     * @param source - 来源标签（如 'persona'、'rule'、'insight'）
+     * @returns 该来源的所有记忆（副本），按 score 降序排列
+     */
+    getBySource(source) {
+        return Array.from(this.memories.values())
+            .filter((m) => m.source === source)
+            .sort((a, b) => b.score - a.score)
+            .map((m) => ({ ...m }));
+    }
+    /**
+     * 文本搜索（内存版）
+     *
+     * 使用 segmentText() 规范分词，与 SqliteStorage 行为一致。
+     * 搜索 content 和 name 字段，按 score 降序排列。
+     *
+     * @param query - 搜索查询文本
+     * @param limit - 返回数量上限（默认 10）
+     * @returns 匹配的记忆列表
+     */
+    search(query, limit = 10) {
+        // 空查询：按 score 降序返回（浅拷贝，读取隔离）
+        if (!query.trim()) {
+            return Array.from(this.memories.values())
+                .sort((a, b) => b.score - a.score)
+                .slice(0, limit)
+                .map((m) => ({ ...m }));
+        }
+        // 规范分词（与 recall.ts extractKeywords 共用 segmentText）
+        const tokens = segmentText(query).map((t) => t.toLowerCase());
+        // 若分词后无有效 token，降级为按 score 返回
+        if (tokens.length === 0) {
+            return Array.from(this.memories.values())
+                .sort((a, b) => b.score - a.score)
+                .slice(0, limit)
+                .map((m) => ({ ...m }));
+        }
+        const results = Array.from(this.memories.values()).filter((m) => {
+            const text = `${m.content} ${m.name}`.toLowerCase();
+            // 任一 token 命中即可
+            return tokens.some((t) => text.includes(t));
+        });
+        // 按 score 降序排序
+        results.sort((a, b) => b.score - a.score);
+        // 返回浅拷贝，避免调用方修改污染存储内部对象
+        return results.slice(0, limit).map((m) => ({ ...m }));
+    }
+    /**
+     * 统计记忆总数
+     */
+    count() {
+        return this.memories.size;
+    }
+    /**
+     * 按来源标签统计记忆数量
+     *
+     * P2-2 优化：直接读取 sourceCountCache，O(1) 复杂度（与 getAllSources 一致）
+     * 原实现 O(n) 遍历所有记忆，与增量缓存设计不一致
+     */
+    countBySource(source) {
+        return this.sourceCountCache.get(source) ?? 0;
+    }
+    /**
+     * 衰减指定来源的记忆 score
+     *
+     * 遍历所有匹配 source 的记忆，按时间衰减。
+     * 生产环境宿主（SqliteStorage）应重写为 SQL UPDATE 批量操作。
+     */
+    decayScores(sources, now) {
+        let count = 0;
+        for (const m of this.memories.values()) {
+            if (!sources.includes(m.source))
+                continue;
+            if (applyDecayToMemory(m, now)) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * 获取所有 source 标签及其记忆数量
+     *
+     * P2-2 优化：直接读取增量维护的 sourceCountCache，O(1) 复杂度。
+     */
+    getAllSources() {
+        return new Map(this.sourceCountCache);
+    }
+    /**
+     * 关闭（内存实现无需关闭）
+     */
+    close() {
+        // 内存实现无需关闭，清空数据即可
+        this.memories.clear();
+        this.sourceCountCache.clear();
+    }
+    // ─── P2-2 source 缓存辅助方法 ─────────────────────────────
+    /** source 计数 +1 */
+    incrementSourceCount(source) {
+        this.sourceCountCache.set(source, (this.sourceCountCache.get(source) ?? 0) + 1);
+    }
+    /** source 计数 -1（减至 0 时移除键） */
+    decrementSourceCount(source) {
+        const current = this.sourceCountCache.get(source);
+        if (current === undefined)
+            return;
+        if (current <= 1) {
+            this.sourceCountCache.delete(source);
+        }
+        else {
+            this.sourceCountCache.set(source, current - 1);
+        }
+    }
+}
+//# sourceMappingURL=inMemoryStorage.js.map

package/dist/memory/inMemoryStorage.js.map

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

package/dist/memory/loader.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 记忆加载器
+ *
+ * 职责：把文件系统的记忆（personas/rules/skills）加载到 SQLite 索引
+ *       启动时：扫描文件 → 写入索引 → 按 source 召回必召记忆
+ *
+ * 这是"万物皆记忆"哲学的代码体现——所有记忆共享同一条加载管线
+ */
+import type { FileStore } from '../memory/store.js';
+import type { IMemoryStorage } from '../memory/storageInterface.js';
+import { type Memory } from '../memory/types.js';
+export interface LoadResult {
+    /** 实际加载到索引的记忆数量 */
+    loaded: number;
+    /** 跳过的记忆（解析失败等） */
+    skipped: number;
+    /** 加载失败的详情 */
+    errors: Array<{
+        file: string;
+        error: string;
+    }>;
+}
+export declare class MemoryLoader {
+    private readonly fileStore;
+    private readonly index;
+    constructor(fileStore: FileStore, index: IMemoryStorage);
+    /**
+     * 扫描所有"配置类"记忆文件（persona/rule/skill）
+     * 写入 SQLite 索引
+     *
+     * @returns 加载结果统计
+     */
+    loadAllToIndex(): Promise<LoadResult>;
+    /**
+     * 启动时的完整引导流程
+     * 1. 扫描配置文件 → 写入索引
+     * 2. 从索引按 source 召回必召记忆（rule + skill）
+     *
+     * 注：persona 记忆由 PersonaManager 单独处理，
+     * bootstrap 中自动跳过 persona（避免与 systemPromptPrefix 中的角色 prompt 重复）。
+     *
+     * @returns 启动时必召的所有记忆（用于初始化 Agent Loop 的 system prompt）
+     */
+    bootstrap(): Promise<{
+        memories: Memory[];
+        loadResult: LoadResult;
+    }>;
+}
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/memory/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AA6B/D,MAAM,WAAW,UAAU;IACzB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,cAAc;IAGxC;;;;;OAKG;IACG,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC;IAgC3C;;;;;;;;;OASG;IACG,SAAS,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE,CAAC;CAW3E"}

package/dist/memory/loader.js

@@ -0,0 +1,93 @@
+import { SOURCE_LABELS } from '../memory/types.js';
+import { toError } from '../utils/errors.js';
+/**
+ * 启动时全量扫描的 source 列表
+ * - insight/profile/work-projection：运行时产生，不由 FileStore 管理
+ * - tool：由 registerTool() 注册为 tool_call，不再重复注入 system prompt
+ * - guardrail：由 AgentLoop 运行时读取，不注入 system prompt
+ */
+const STARTUP_SCAN_SOURCES = [
+    SOURCE_LABELS.PERSONA,
+    SOURCE_LABELS.RULE,
+    SOURCE_LABELS.SKILL,
+    SOURCE_LABELS.GUARDRAIL,
+];
+/**
+ * 判断内容是否为空壳模板（仅含标题和 blockquote 占位说明）
+ * 新建项目时的空壳规则模板属于此类
+ *
+ * 判断逻辑：过滤掉标题行和空行后，剩余内容全部是 blockquote 行
+ */
+function isPlaceholderContent(memory) {
+    const trimmed = memory.content.trim();
+    if (trimmed.length > 200)
+        return false;
+    const lines = trimmed.split('\n').filter(l => l.trim() && !l.trim().startsWith('#'));
+    return lines.length > 0 && lines.every(l => l.trim().startsWith('>'));
+}
+export class MemoryLoader {
+    fileStore;
+    index;
+    constructor(fileStore, index) {
+        this.fileStore = fileStore;
+        this.index = index;
+    }
+    /**
+     * 扫描所有"配置类"记忆文件（persona/rule/skill）
+     * 写入 SQLite 索引
+     *
+     * @returns 加载结果统计
+     */
+    async loadAllToIndex() {
+        const result = { loaded: 0, skipped: 0, errors: [] };
+        for (const source of STARTUP_SCAN_SOURCES) {
+            const names = await this.fileStore.list(source);
+            for (const name of names) {
+                try {
+                    const memory = await this.fileStore.read(source, name);
+                    if (!memory) {
+                        result.skipped++;
+                        continue;
+                    }
+                    // 跳过空壳模板（新建项目时的占位文件，无实质规则内容）
+                    if (isPlaceholderContent(memory)) {
+                        result.skipped++;
+                        continue;
+                    }
+                    this.index.upsert(memory);
+                    result.loaded++;
+                }
+                catch (err) {
+                    result.skipped++;
+                    result.errors.push({
+                        file: `${source}/${name}`,
+                        error: toError(err).message,
+                    });
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * 启动时的完整引导流程
+     * 1. 扫描配置文件 → 写入索引
+     * 2. 从索引按 source 召回必召记忆（rule + skill）
+     *
+     * 注：persona 记忆由 PersonaManager 单独处理，
+     * bootstrap 中自动跳过 persona（避免与 systemPromptPrefix 中的角色 prompt 重复）。
+     *
+     * @returns 启动时必召的所有记忆（用于初始化 Agent Loop 的 system prompt）
+     */
+    async bootstrap() {
+        const loadResult = await this.loadAllToIndex();
+        // 按 source 获取 rule 和 skill 记忆（跳过 persona，由 PersonaManager 单独管理）
+        const rules = this.index.getBySource(SOURCE_LABELS.RULE);
+        const skills = this.index.getBySource(SOURCE_LABELS.SKILL);
+        const memories = [...rules, ...skills];
+        return {
+            memories,
+            loadResult,
+        };
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/memory/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/memory/loader.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,aAAa,EAAe,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,oBAAoB,GAAa;IACrC,aAAa,CAAC,OAAO;IACrB,aAAa,CAAC,IAAI;IAClB,aAAa,CAAC,KAAK;IACnB,aAAa,CAAC,SAAS;CACxB,CAAC;AAEF;;;;;GAKG;AACH,SAAS,oBAAoB,CAAC,MAAc;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACrF,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACxE,CAAC;AAWD,MAAM,OAAO,YAAY;IAEJ;IACA;IAFnB,YACmB,SAAoB,EACpB,KAAqB;QADrB,cAAS,GAAT,SAAS,CAAW;QACpB,UAAK,GAAL,KAAK,CAAgB;IACrC,CAAC;IAEJ;;;;;OAKG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,MAAM,GAAe,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAEjE,KAAK,MAAM,MAAM,IAAI,oBAAoB,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;oBACvD,IAAI,CAAC,MAAM,EAAE,CAAC;wBACZ,MAAM,CAAC,OAAO,EAAE,CAAC;wBACjB,SAAS;oBACX,CAAC;oBACD,6BAA6B;oBAC7B,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;wBACjC,MAAM,CAAC,OAAO,EAAE,CAAC;wBACjB,SAAS;oBACX,CAAC;oBACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBAC1B,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,OAAO,EAAE,CAAC;oBACjB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;wBACjB,IAAI,EAAE,GAAG,MAAM,IAAI,IAAI,EAAE;wBACzB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO;qBAC5B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC/C,gEAAgE;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC;QACvC,OAAO;YACL,QAAQ;YACR,UAAU;SACX,CAAC;IACJ,CAAC;CACF"}

package/dist/memory/projectManager.d.ts

@@ -0,0 +1,182 @@
+import { FileStore } from '../memory/store.js';
+import type { IMemoryStorage } from '../memory/storageInterface.js';
+import type { LoadResult } from '../memory/loader.js';
+import type { SecurityGuard } from '../security/pathGuard.js';
+import { type Memory } from '../memory/types.js';
+/**
+ * 项目上下文：打开一个项目后产出的一组组件
+ * 与 DomainContext 类似，但增加了项目级别的信息
+ */
+export interface ProjectContext {
+    /** 项目根目录的绝对路径 */
+    projectPath: string;
+    /** 项目名称（从注册表读取，或取目录名） */
+    projectName: string;
+    /** .memora/ 目录的绝对路径 */
+    memoraDir: string;
+    /** Agent 级 memora.db 路径（全局共享，非项目级） */
+    dbPath: string;
+    /** 文件存储 */
+    fileStore: FileStore;
+    /** SQLite 索引（通过 IMemoryStorage 接口访问） */
+    index: IMemoryStorage;
+    /** 安全守卫（A-004: 可空，由 Agent 层注入工厂函数创建） */
+    security: SecurityGuard | null;
+    /** 启动时加载的必召记忆 */
+    bootstrapMemories: Memory[];
+    /** 加载结果 */
+    loadResult: LoadResult;
+}
+/**
+ * 项目注册表条目
+ */
+export interface ProjectEntry {
+    /** 项目根目录的绝对路径 */
+    path: string;
+    /** 项目名称（用户自定义或目录名） */
+    name: string;
+    /** 最后打开时间 */
+    lastOpened: string;
+}
+/**
+ * ProjectManager 构造选项
+ */
+export interface ProjectManagerOptions {
+    /** Agent 级数据目录（memora.db 所在目录） */
+    dataDir: string;
+    /** 外部注入的存储实例（可选，不传则内部创建 InMemoryStorage 兜底） */
+    storage?: IMemoryStorage;
+    /** 注册表目录（可选，默认与 dataDir 相同） */
+    registryDir?: string;
+    /**
+     * A-004: SecurityGuard 工厂函数（由 Agent 层注入，解除 memory→security 反向依赖）
+     *
+     * 在项目切换时调用，传入项目路径、.memora/ 目录、Agent 级配置目录和数据目录，
+     * 返回一个配置好的 SecurityGuard 实例。
+     * 不提供时 ProjectContext.security 为 null（宿主需自行处理安全校验）。
+     */
+    createSecurityGuard?: (projectPath: string, memoraDir: string, configDir?: string, agentDataDir?: string) => SecurityGuard;
+}
+/**
+ * 项目管理器
+ *
+ * 管理多项目的生命周期：
+ * 1. 初始化当前项目（加锁 + 加载两层配置）
+ * 2. /project <name> 切换到新项目（解锁旧项目 + 加锁新项目）
+ * 3. 退出时清理锁文件
+ */
+export declare class ProjectManager {
+    /** 项目注册表路径 */
+    private readonly registryPath;
+    /** Agent 级数据目录（memora.db 所在目录） */
+    private readonly agentDataDir;
+    /** Agent 级存储实例（全局共享，不随项目切换重建） */
+    private agentIndex;
+    /** 当前打开的项目路径 */
+    private currentProjectPath;
+    /** 当前持有的锁文件路径 */
+    private currentLockPath;
+    /** 外部注入的存储实例（可选，不传则内部创建 InMemoryStorage 兜底） */
+    private externalStorage;
+    /** A-004: SecurityGuard 工厂函数（由 Agent 层注入） */
+    private readonly createSecurityGuard?;
+    constructor(options: ProjectManagerOptions);
+    /**
+     * 确保 Agent 级资源已初始化（存储实例）
+     * 存储实例在整个 Agent 生命周期内共享，不随项目切换重建
+     *
+     * 如果构造时注入了外部存储实例，直接使用；
+     * 否则内部创建 InMemoryStorage（非持久化兜底，仅开发/测试用）。
+     */
+    private ensureAgentResources;
+    /**
+     * 初始化指定项目
+     *
+     * 两层记忆加载：
+     *   1) 项目级：扫描 projectPath/.memora/rules/ + skills/
+     *   2) Agent 级：扫描 configDir 下的所有配置（rules/skills/personas/tools）
+     *
+     * 全局规则不再由内核硬编码路径，宿主可通过 configDir 统一管理。
+     *
+     * memora.db 是 Agent 级共享资源，不随项目切换重建。
+     *
+     * @param projectPath 项目根目录
+     * @param projectName 项目名称（可选，默认取目录名）
+     * @param configDir Agent 级配置目录（personas/rules/skills/tools）
+     */
+    initProject(projectPath: string, projectName?: string, configDir?: string): Promise<ProjectContext>;
+    /**
+     * 关闭当前项目
+     * 释放锁文件，但不关闭 Agent 级数据库（memora.db 是共享的）
+     */
+    closeProject(): Promise<void>;
+    /**
+     * 完全关闭：释放项目锁 + 关闭 Agent 级数据库
+     * 应在 Agent 整体关闭时调用（而非项目切换时）
+     */
+    shutdown(): Promise<void>;
+    /**
+     * 列出已注册的项目（IX-02：统一为 getter 风格，与 persona/skill 一致）
+     */
+    get list(): ProjectEntry[];
+    /**
+     * 列出已注册的项目
+     * @deprecated 请使用 `projectManager.list` getter 代替
+     */
+    listProjects(): ProjectEntry[];
+    /**
+     * 注册项目到注册表
+     */
+    registerProject(projectPath: string, name: string): void;
+    /**
+     * 从注册表移除项目
+     */
+    unregisterProject(projectPath: string): void;
+    /**
+     * 获取当前项目路径
+     */
+    get currentProject(): string | null;
+    /**
+     * 获取锁文件
+     * 如果锁文件存在且进程存活，发出警告但不阻止
+     * 如果锁文件存在但进程已死，清理残留锁
+     */
+    private acquireLock;
+    /**
+     * 释放锁文件
+     */
+    private releaseLock;
+    /**
+     * 安全删除文件（忽略不存在的错误）
+     */
+    private safeUnlink;
+    /**
+     * 检查进程是否存活
+     * Windows: tasklist /FI "PID eq <pid>"
+     * POSIX: kill(pid, 0)
+     */
+    private isProcessAlive;
+    /**
+     * 解析项目的 .memora/ 目录路径
+     * 每个项目有独立的 .memora/ 目录（在项目根目录下）
+     * 这与 config.memory.dataDir（用户级默认目录）不同
+     */
+    private resolveMemoraDir;
+    /**
+     * 从项目路径推断项目名称
+     * 取路径最后一段目录名
+     */
+    private inferProjectName;
+    /**
+     * 读取项目注册表
+     *
+     * 同步读取：list getter 契约要求同步返回，注册表操作低频，同步 I/O 影响可控
+     * 损坏时返回空数组并记录警告日志，避免静默吞错掩盖磁盘故障
+     */
+    private readRegistry;
+    /**
+     * 写入项目注册表
+     */
+    private writeRegistry;
+}
+//# sourceMappingURL=projectManager.d.ts.map

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

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